Syntax 1 System-defined shape
Description
Sets the mouse pointer to a specified system-defined shape.
Syntax
1 |
<span>SetPointer</span> ( <span>type</span> ) |
Argument |
Description |
---|---|
type |
A value of the Pointer enumerated datatype
|
Return Values
Pointer. Returns the enumerated type of the pointer it replaced
so the script can restore it, if necessary. If type is null, SetPointer returns null.
Usage
Use SetPointer to display an hourglass
at the beginning of a script when the script will take a long time
to execute. The pointer remains set until you change it again in
the script or the script terminates.

The pointer automatically changes back to an arrow when the
script finishes executing. You do not have to change it back to
an arrow.
In PowerBuilder’s painters, you can specify the pointer
shape that PowerBuilder displays when the user moves the pointer
over a window, a control, or specific parts of a DataWindow object.
The available shapes include the stock pointers listed above, as
well as any custom cursor files you have.
Examples
This statement sets the pointer to the hourglass
shape:
1 |
<span>SetPointer</span>(HourGlass!) |
This example saves the old pointer and restores it
when a long activity is completed:
1 |
pointer oldpointer // Declares a pointer variable |
1 |
oldpointer = <span>SetPointer</span>(HourGlass!) |
1 |
... // Performs some long activity |
1 |
SetPointer(oldpointer) |