mousePointer

Type: Integer

Availability: Read or write at any time, but the setting is ignored at development time

The mousePointer property of the Window class contains the type of mouse pointer that is displayed when the mouse is over a specific part of a form or control at run time. The mousePointer property controls the shape of the mouse pointer.

Use this property when you want to indicate changes in functionality as the mouse pointer passes over controls on a form or control. Use the MousePointer_HourGlass (11) value to indicate that the user should wait for a process or operation to finish. To restore the previous behavior of the mouse pointer, set the mousePointer property value to MousePointer_Default (0).

If the mousePointer property of the Application class is set to a non-zero value, the mousePointer property value of the form or control is ignored. The application mousePointer property enables the mouse pointer to be set globally for the whole application; for example, as an hourglass.

The settings of the mousePointer property are listed in the following table.

Window Class Constant	Value	Description
MousePointer_Default	0	Default value determined by the current window (for example, an arrow or hourglass).
MousePointer_Arrow	1	Arrow ( ).
MousePointer_Cross	2	Cross ( cross-hair pointer).
MousePointer_IBeam	3	I-Beam ().
MousePointer_Cursor	4	User-defined cursor not provided by the system. (See the Window class mouseCursor property.)
MousePointer_Size	5	Size ( four-pointed arrow pointing north, south, east, west).
MousePointer_NESW	6	Size NE SW ( double arrow pointing north east and south west).
MousePointer_NS	7	Size N S ( double arrow pointing north and south).
MousePointer_NWSE	8	Size NW SE ( double arrow pointing north west and south east).
MousePointer_WE	9	Size W E ( double arrow pointing west and east).
MousePointer_UpArrow	10	Up arrow ().
MousePointer_HourGlass	11	Hourglass (wait) .
MousePointer_NoDrop	12	No drop ( ).
MousePointer_Drag	13	Standard Jade drag cursor ( ).
MousePointer_HorizontalLine	14	Cursor used to drag a horizontal line ( ).
MousePointer_VerticalLine	15	Cursor used to drag a vertical line ( ).
MousePointer_HandPointing	16	Cursor used for hyperlinks ( ).

The following example shows the use of the mousePointer property.

bCancel_dragDrop(btn:  Button input;
                 win:  Window input;
                 x, y: Real) updating;
begin
    mousePointer       := MousePointer_NoDrop;
    bCancel.bubbleHelp := "Cannot Drop Here";
    doWindowEvents(2000);
    mousePointer       := MousePointer_Arrow;
    bCancel.bubbleHelp := null;
end;