Programming Guide


Changes the state of the mouse pointer

int sm_delay_cursor (int state);

Specifies the cursor's new state with one of these arguments:

Toggles the mouse pointer between the default cursor and the delay cursor depending on whether the application is awaiting input or not. The default cursor appears whenever Panther is awaiting input.

Changes the mouse pointer into the delay cursor.

Restores the default cursor.

Leaves the mouse pointer unchanged. Use this argument to get the pointer's current state.

Temporarily changes the mouse pointer to the delay cursor. Panther restores the mouse pointer to the default cursor after Panther refreshes the screen.



sm_delay_cursor sets the mouse pointer to be either the default cursor or the delay cursor, or gets the mouse pointer's current state, according to the value of state. It can also specify to change the cursor's state automatically, depending on whether the application is awaiting input or not.

You can set the default cursor for a screen through the pointer property. In Windows and Motif, the default cursor is an arrow. The delay cursor in Windows is an hourglass; in Motif, the delay cursor is usually a wristwatch icon. You can change Motif's default cursor through the pointerShape resource.

Because character-mode Panther does not change the mouse pointer shape, sm_delay_cursor resets the background status line message to the value of SM_WAIT or SM_READY. Note that you can turn background status messages on and off through sm_setstatus.