Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 8 - Cursor Utilities / Cursor Utilities Reference

Routines / Hiding and Showing Cursors

Show_Cursor

You use the Show_Cursor procedure to display the cursor on the screen if you have used the Hide_Cursor procedure (described on page 8-26) to remove the cursor from the screen.

PROCEDURE Show_Cursor (cursorKind: Cursors);

cursorKind

The kind of cursor to show. To specify one of the standard cursors, you can use one of these values defined by the Cursors data type.

          TYPE Cursors =      {values to pass Show_Cursor}
            (HIDDEN_CURSOR,   {the current cursor}
             I_BEAM_CURSOR,   {the I-beam cursor; to select text}
             CROSS_CURSOR,    {the crosshairs cursor; to draw }
                              { graphics}
             PLUS_CURSOR,     {the plus sign cursor; to select }
                              { cells}
             WATCH_CURSOR,    {the wristwatch cursor; to } 
                              { indicate a short operation in }
                              { progress}
             ARROW_CURSOR);   {the standard cursor}

DESCRIPTION

The Show_Cursor procedure increments the cursor level, which may have been decremented by the Hide_Cursor procedure, and displays the specified cursor on the screen only if the level becomes 0 (it is never incremented beyond 0). You can specify one of the standard cursors or the current cursor by passing one of the previously listed values in the cursorKind parameter. If you specify one of the standard cursors, the Show_Cursor procedure calls the SetCursor procedure for the specified cursor prior to calling ShowCursor. If you specify HIDDEN_CURSOR, this procedure just calls ShowCursor. Before using Show_Cursor, you must use the InitCursorCtl procedure, which is described on page 8-20.

SPECIAL CONSIDERATIONS

The value ARROW_CURSOR works correctly only if the basic QuickDraw global variables have been set up by using the InitGraf procedure, which is described in the chapter "Basic QuickDraw" in this book.

SEE ALSO

Figure 8-3 on page 8-8 illustrates the cursors represented by the Cursors data type.