Programming Guide |
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.
- · The mouse pointer's previous state, one of the arguments specified for the parameter
state
, excludingSM_SAME_CURSOR
.
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 ofstate
. 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 ofSM_WAIT
orSM_READY
. Note that you can turn background status messages on and off through sm_setstatus.