SetPointer

Sets the mouse pointer to a specified shape.

To

Use

Specifies a system-defined designated shape

Syntax 1

Specifies a file-defined designated shape

Syntax 2


Syntax 1: System-defined shape

Description

Sets the mouse pointer to a specified system-defined shape.

Syntax

SetPointer ( type )

Argument

Description

type

A value of the Pointer enumerated datatype indicating the type of pointer you want. Values are:

AppStarting!

Arrow!

Cross!

Beam!

Help!

HourGlass!

Hyperlink!

Icon!

None!

Size!

SizeNS!

SizeNESW!

SizeWE!

SizeNWSE!

UpArrow!


Return value

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.

Restoring the arrow pointer

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:

SetPointer(HourGlass!)

This example saves the old pointer and restores it when a long activity is completed:

pointer oldpointer // Declares a pointer variable
oldpointer = SetPointer(HourGlass!)
... // Performs some long activity
SetPointer(oldpointer)

Syntax 2: File-defined shape

Description

Sets the mouse pointer to a specified system-defined shape.

Syntax

SetPointer ( shape  )

Argument

Description

shape

A string reference to a CUR file specifying the pointer type that you want to use.


Return value

Pointer. Returns an enumerated type for the pointer. However, this value should be ignored when you set the pointer with a shape from a CUR file. If shape is null, SetPointer returns null.