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
Available with ArcGIS Engine.
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.