This method allows you to define a custom mouse cursor. To change the cursor you must first set the cursor input mode to 1 (MI_COM_CLIENT), using IRender4::SetMouseInputMode().
HRESULT SetMouseCursor(
[in] BSTR CursorFileName)
Parameters:
CursorFileName – A full path name or a URL to the cursor file. The file should be a standard windows cursor file (e.g., *.cur, *.ani)
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. |
|
TE_E_RENDER_WRONGINPUTMODE |
Mouse input mode must be MI_COM_CLIENT for this method to take effect |