Table of Contents

SETCURSOR method (System)

Description

Sets the cursor image to the specified image.

Syntax

CurrentCursor = Exec_Method( "SYSTEM", "SETCURSOR", NewCursor )

Parameters

NameRequiredDescription
NewCursorNoSpecifies 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