ISceneControl.Navigate Property

Indicates if the SceneControl performs default scene navigation in response to mouse events.

[Visual Basic .NET]
Public Property Navigate As Boolean

[C#]
public bool Navigate {get; set;}

[C++]
HRESULT get_Navigate(
  VARIANT_BOOL* pVal
);

[C++]
HRESULT put_Navigate(
  VARIANT_BOOL pVal
);

[C++]

Parameters
pVal [out, retval]
  pVal is a parameter of type VARIANT_BOOL
pVal [in]
  pVal is a parameter of type VARIANT_BOOL

Product Availability

Description

The Navigate property determines whether the default SceneControl navigation functionality is enabled at run time. By default the Navigate property is set to false. When the Navigate property is set to true, the end user can use the left mouse button to navigate backwards and forwards and to the left and right of the display, and the right mouse button to zoom in and out on the display.

Remarks

When the Navigate property is set to true, the OnMouseDown, OnMouseMove, OnMouseUp events are being intercepted. As such, care must be taken by developers to avoid the display becoming confused when:

• The OnMouseDown, OnMouseMove, OnMouseUp events contain code that interacts with the Camera.
• The SceneControl is being used in conjunction with the ToolbarControl with Control Commands or custom commands hosted on it. When a command hosted on the ToolbarControl is selected by the end user to become the CurrentTool, both the Navigate functionality and the CurrentTool are catching the OnMouseDown, OnMouseMove, OnMouseUp events.

See Also