Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 8 - Cursor Utilities / Cursor Utilities Reference

Routines / Hiding and Showing Cursors

ShowCursor

You use the ShowCursor procedure to display a cursor hidden by the HideCursor or ShieldCursor procedure.

PROCEDURE ShowCursor;

DESCRIPTION

The ShowCursor procedure increments the cursor level, which may have been decremented by the HideCursor or ShieldCursor procedure, and displays the cursor on the screen when the level is 0. A call to the ShowCursor procedure should balance each previous call to the HideCursor or ShieldCursor procedure. The level isn't incremented beyond 0, so extra calls to ShowCursor have no effect.

Low-level interrupt-driven routines link the cursor with the mouse position, so that if the cursor level is 0 (visible), the cursor automatically follows the mouse.

If the cursor has been changed with the SetCursor procedure while hidden, ShowCursor displays the new cursor.

SEE ALSO

For a description of the HideCursor procedure, see page 8-26. The ShieldCursor procedure is described on page 8-27, and the SetCursor procedure is described on page 8-23.