Graphics2DControlBase#

class ansys.stk.core.stkx.Graphics2DControlBase#

AGI Map control.

Overview#

picture_put_reference

Set a reference to the splash logo graphic to be displayed in the control.

zoom_in

Enter zoom-in mode. User must left click-and-drag mouse to define area to zoom.

zoom_out

Zoom out to view a larger portion of a previously magnified map.

pick_info

Get detailed information about a mouse pick.

copy_from_window_id

Copy an existing Window’s scene into this control.

rubber_band_pick_info

Get detailed information about a rubber-band mouse pick. The values must be within the 2D window (0 to width-1 for left and right, 0 to height-1 for top and bottom).

get_window_projected_position

Get the window projected position for given values.

set_mouse_cursor_from_file

Set mouse cursor to the selected cursor file.

restore_mouse_cursor

Restores mouse cursor back to normal.

set_mouse_cursor_from_handle

Set mouse cursor to the passed cursor handle.

subscribe

β€œβ€β€Return an IUiAxGraphics2DCntrlEventHandler that is subscribed to handle events associated with this instance of Graphics2DControlBase.”””

back_color

The background color of the control.

picture

The splash logo graphic to be displayed in the control.

window_id

Window identifier (for Connect commands).

application

Reference to the STK X application object.

no_logo

If true, the splash logo is not shown.

ole_drop_mode

How the control handles drop operations.

vendor_id

Do not use this property, as it is deprecated. The identifier of the vendor.

mouse_mode

Whether this control responds to mouse events.

ready_state

Return/sets the background color of the control.

advanced_pick_mode

If true, sets the advance pick mode.

in_zoom_mode

Return true if in zoom in mode.

show_progress_image

The animated progress image type.

progress_image_x_offset

The horizontal X offset for animated progress image.

progress_image_y_offset

The vertical Y offset for animated progress image.

progress_image_file

The complete image file name/path for animated progress image.

progress_image_x_origin

The X origin alignment for animated progress image.

progress_image_y_origin

The Y origin alignment for animated progress image.

picture_from_file

Get or set the splash logo graphic file to be displayed in the control.

pan_mode_enabled

Enable/disable pan mode for map control.

Import detail#

from ansys.stk.core.stkx import Graphics2DControlBase

Property detail#

property Graphics2DControlBase.back_color: Color#

The background color of the control.

property Graphics2DControlBase.picture: IPictureDisp#

The splash logo graphic to be displayed in the control.

property Graphics2DControlBase.window_id: int#

Window identifier (for Connect commands).

property Graphics2DControlBase.application: STKXApplication#

Reference to the STK X application object.

If true, the splash logo is not shown.

property Graphics2DControlBase.ole_drop_mode: OLEDropMode#

How the control handles drop operations.

property Graphics2DControlBase.vendor_id: str#

Do not use this property, as it is deprecated. The identifier of the vendor.

property Graphics2DControlBase.mouse_mode: MouseMode#

Whether this control responds to mouse events.

property Graphics2DControlBase.ready_state: int#

Return/sets the background color of the control.

property Graphics2DControlBase.advanced_pick_mode: bool#

If true, sets the advance pick mode.

property Graphics2DControlBase.in_zoom_mode: bool#

Return true if in zoom in mode.

property Graphics2DControlBase.show_progress_image: ShowProgressImage#

The animated progress image type.

property Graphics2DControlBase.progress_image_x_offset: int#

The horizontal X offset for animated progress image.

property Graphics2DControlBase.progress_image_y_offset: int#

The vertical Y offset for animated progress image.

property Graphics2DControlBase.progress_image_file: str#

The complete image file name/path for animated progress image.

property Graphics2DControlBase.progress_image_x_origin: ProgressImageXOrigin#

The X origin alignment for animated progress image.

property Graphics2DControlBase.progress_image_y_origin: ProgressImageYOrigin#

The Y origin alignment for animated progress image.

property Graphics2DControlBase.picture_from_file: str#

Get or set the splash logo graphic file to be displayed in the control.

property Graphics2DControlBase.pan_mode_enabled: bool#

Enable/disable pan mode for map control.

Method detail#

Graphics2DControlBase.picture_put_reference(self, picture: IPictureDisp) None#

Set a reference to the splash logo graphic to be displayed in the control.

Parameters:

picture : IPictureDisp

Returns:

None

Graphics2DControlBase.zoom_in(self) None#

Enter zoom-in mode. User must left click-and-drag mouse to define area to zoom.

Returns:

None

Graphics2DControlBase.zoom_out(self) None#

Zoom out to view a larger portion of a previously magnified map.

Returns:

None

Graphics2DControlBase.pick_info(self, x: int, y: int) PickInfoData#

Get detailed information about a mouse pick.

Parameters:

x : int

y : int

Returns:

PickInfoData

Graphics2DControlBase.copy_from_window_id(self, win_id: int) None#

Copy an existing Window’s scene into this control.

Parameters:

win_id : int

Returns:

None

Graphics2DControlBase.rubber_band_pick_info(self, left: int, top: int, right: int, bottom: int) RubberBandPickInfoData#

Get detailed information about a rubber-band mouse pick. The values must be within the 2D window (0 to width-1 for left and right, 0 to height-1 for top and bottom).

Parameters:

left : int

top : int

right : int

bottom : int

Returns:

RubberBandPickInfoData

Graphics2DControlBase.get_window_projected_position(self, lat: float, lon: float, alt: float, draw_coords: Graphics2DDrawCoordinates) WindowProjectionPosition#

Get the window projected position for given values.

Parameters:

lat : float

lon : float

alt : float

draw_coords : Graphics2DDrawCoordinates

Returns:

WindowProjectionPosition

Graphics2DControlBase.set_mouse_cursor_from_file(self, cursor_file_name: str) None#

Set mouse cursor to the selected cursor file.

Parameters:

cursor_file_name : str

Returns:

None

Graphics2DControlBase.restore_mouse_cursor(self) None#

Restores mouse cursor back to normal.

Returns:

None

Graphics2DControlBase.set_mouse_cursor_from_handle(self, cursor_handle: int) None#

Set mouse cursor to the passed cursor handle.

Parameters:

cursor_handle : int

Returns:

None