This method determines the input mode of the mouse. Different input modes allow you to control the behavior of the mouse. For example, in free flight mode clicking with the mouse on the various areas of the 3D Window, changes the camera’s yaw or tilt. This makes it hard to click a point on the terrain to place an object. Instead you can use the COM client mode that does not change the camera position.
HRESULT SetMouseInputMode(
[in] MouseInputMode InputMode)
Parameters:
InputMode – Determines the mouse input mode. The following are the possible Input modes:
MI_FREE_FLIGHT = 0
The default input mode, allows moving the camera by clicking on the
3D window. Provides right-click pop-up menu.
MI_COM_CLIENT = 1
In this mode there are no actions set for clicking or moving the
mouse. You can control the actions using the mouse events available
in _ITerraExplorerEvents4.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_MPTNOTLOADED |
An MPT file must be loaded in TerraExplorer for this method to work. |