Programming Guide



sm_delay_cursor

Changes the state of the mouse pointer

int sm_delay_cursor (int state);

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

SM_AUTO_BUSY_CURSOR
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.

SM_BUSY_CURSOR
Changes the mouse pointer into the delay cursor.

SM_DEFAULT_CURSOR
Restores the default cursor.

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

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

Returns

Description

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.