STK XSend comments on this topic.
AgUiAxVOCntrl Object

Description

The 3D Globe window control.


By default, you can use the mouse in the following ways to manipulate the 3D Graphics window:



  • Double-click the left mouse button on any spot on the globe to display the latitude and longitude of the selected spot. The latitude and longitude are shown in the scenario lat-lon units which can be found and changed in the Scenario > Basic > Units properties window.
  • Use the left mouse button to rotate the globe.
  • Use the right mouse button to zoom in and out. You can also zoom into a portion of the 3D Graphics window by clicking the zoom button and then using the left mouse button to drag out a region to view on the 3D Graphics window.
  • Use the Shift-left mouse button to pan and tilt the virtual camera; that is, keep the camera in a fixed point in space and change its orientation.
  • Use the mouse and the 3D Object Editor to edit an object in the 3D Graphics window.

The mouse works as follows in Grab mode:



  • Moving the mouse while the left button is depressed rotates the globe.
  • Moving the mouse while the right button is depressed zooms in and out.
  • Moving the mouse while the left button and shift key are depressed grabs the central globe and rotates it.

  • When you go into Grab mode, you are placed in the lat/lon/alt view mode, if you are not already in it.

If the Constrained "Up" Vector is selected on the View From/To dialog box, the view may shift slightly to keep the "up" vector up.

Public Methods

Public Method ApplyObjectEditingCommits changes when in 3D object editing mode.
Public Method CopyFromWinIDCopies an existing Window's scene into this control
Public Method PickInfoGet detailed information about a mouse pick.
Public Method Picture
Public Method RestoreMouseCursorRestores mouse cursor back to normal.
Public Method RubberBandPickInfoGet detailed information about a rubber-band mouse pick. The values must be within the VO window (0 to width-1 for left and right, 0 to height-1 for top and bottom).
Public Method SetMouseCursorFromFileSets mouse cursor to the selected cursor file.
Public Method SetMouseCursorFromHandleSets mouse cursor to the passed cursor handle.
Public Method StartObjectEditingEnters into 3D object editing mode.
Public Method StopObjectEditingEnds 3D object editing mode.
Public Method ZoomInEnter zoom-in mode. User must left click-and-drag mouse to define area to zoom.

Public Properties

Public Property AdvancedPickModeIf true, sets the advance pick mode.
Public Property ApplicationReference to the STK X application object.
Public Property BackColorThe background color of the control.
Public Property DrawElementsElements to draw on the control.
Public Property InZoomModeReturns true if in zoom in mode.
Public Property IsObjectEditingReturns true if in 3D object editing mode.
Public Property MouseModeWhether this control responds to mouse events.
Public Property NoLogoIf true, the splash logo is not shown.
Public Property OLEDropModeHow the control handles drop operations.
Public Property PictureThe splash logo graphic to be displayed in the control.
Public Property PictureFromFileThe splash logo graphic file to be displayed in the control.
Public Property PptPreloadModeSpecial mode for PowerPoint : if true the VO control window is kept around when switching between slides.
Public Property ProgressImageFileThe complete image file name/path for animated progress image.
Public Property ProgressImageXOffsetThe horizontal X offset for animated progress image.
Public Property ProgressImageXOriginThe X origin alignment for animated progress image.
Public Property ProgressImageYOffsetThe vertical Y offset for animated progress image.
Public Property ProgressImageYOriginThe Y origin alignment for animated progress image.
Public Property ShowProgressImageThe animated progress image type.
Public Property VendorIDThis property is deprecated. The identifier of the vendor.
Public Property WinIDWindow identifier (for Connect commands).

Events

Public Event KeyDownOccurs when the user presses a key while the control has the focus.
Public Event KeyPressOccurs when the user presses and releases a key or key combination that corresponds to an ANSI code.
Public Event KeyUpOccurs when the user releases a key while the control has the focus.
Public Event ClickOccurs when the user presses and then releases a mouse button over the control.
Public Event DblClickOccurs when the user presses and releases a mouse button and then presses and releases it again over the control.
Public Event MouseDownOccur when the user presses a mouse button.
Public Event MouseMoveOccurs when the mouse pointer is moved across the control.
Public Event MouseUpOccurs when the user releases a mouse button.
Public Event OLEDragDropFired when a source component is dropped onto the control
Public Event MouseWheelOccurs when the mouse wheel is rotated on the control.
Public Event OnObjectEditingStartTriggered when a 3D object enters in edit mode.
Public Event OnObjectEditingApplyTriggered when a 3D object editing changes are applied.
Public Event OnObjectEditingCancelTriggered when a 3D object edit mode is canceled.
Public Event OnObjectEditingStopTriggered when a 3D object exits the edit mode.

Remarks

The Globe control can be created as any regular ActiveX control.


GUID{0E939AC2-43D9-456E-9FE7-4C3C687BCDF2}
ProgIDSTKX12.VOControl


The STK Objects library is also available with STK X. You can instantiate the root object and from it navigate and manipulate the STK scenario. Please see STK Objects for more details.


Click here for instructions on adding STK X controls to a Visual Studio project.


© 2024 Analytical Graphics, Inc. All Rights Reserved.