Mouse Pointer (Cursor)

Image used when the mouse pointer is positioned over the widget. The default depends on the widget.

"Cursor=CursorName"

CursorName

Representation

Description
UAppStarting Arrotw and hourglass

Standard arrow and small hourglass
UArrow Standard arrow cursor

Standard arrow
UCrosshair Crosshair cursor

Crosshair
UHand Hand cursor

Hand

UHelp Arrow and question mark

Arrow and question mark
UIBeam I-beam

I-beam
UNo Slashed circle

Slashed circle
USizeAll Four-pointed arrow

Four-pointed arrow pointing north, south, east, and west
USizeNESW Double-pointed arrow

Double-pointed arrow pointing northeast and southwest
USizeNS Double-pointed arrow

Double-pointed arrow pointing north and south
USizeNWSE Double-pointed arrow pointing

Double-pointed arrow pointing northwest and southeast
USizeWE Double-pointed arrow

Double-pointed arrow pointing west and east
UUpArrow Vertical arrow cursor

Vertical arrow
UWait Hourglass cursor

Hourglass

Description

Specifies the system cursor image to be used on mouse roll-over, that is, when the mouse pointer is positioned over the widget.

Setting in ProcScript

You can set the value of the Cursor property in ProcScript using the $properties or $fieldproperties functions, for example:

$fieldproperties(EDITFIELD)="cursor=uarrow"

If you set the Cursor property with $properties, every occurrence of the field shows the same cursor. If you set it with $fieldproperties, the cursor is shown only on the field in the current occurrence.

To ensure that the desired occurrence is the current one, use setocc prior to $fieldproperties, for example during initialization (when retrieving data) or when the user performs an action (such as clicking a button). setocc does not switch the focus, so no triggers are fired, which could interfere with displaying mouse cursors.