SETCURSOR method (System)
Description
Sets the cursor image to the specified image.
Syntax
CurrentCursor = Exec_Method( "SYSTEM", "SETCURSOR", NewCursor )
Parameters
| Name | Required | Description |
|---|---|---|
| NewCursor | No | Specifies the new cursor to display. The format of the parameter is the same as the SYSTEM CURSOR property, i.e. • A path and file name of a cursor (.CUR) file. • A path and file name to a resource file (such as a DLL) containing the cursor image, along with its resource ID. • A symbol that specifies one of the standard Windows cursors. This value can also be NULL$ to let Windows display the default cursor. |
Returns
The current cursor value if set, or NULL$ otherwise.
Remarks
Using this property to set the cursor changes it immediately, but this change is not persistent, i.e. the next time a control or window receives a WM_SETCURSOR message the cursor will revert to the default shape. If you wish to use a persistent value that is preserved across WM_SETCURSOR messages then use the CURSOR property instead.
See Also
Common GUI CURSOR property, SYSTEM CURSOR property