GetCursor

Get a handle to a specified 'CURS' resource

#include <ToolUtils.h> Toolbox Utilities

short cursorID ; resource ID of desired cursor

returns handle leading to a 68-byte Cursor; 0 if error

GetCursor searches the resource list until it finds the specified cursor. It

reads the resource from disk (if necessary) and returns a handle to a 68-byte

Cursor structure.

cursorID is the resource identifier of the desired cursor.

Returns: a 32-bit Handle leading to the cursor data. If the resource ID

cursorID can't be found, the return value is NIL.

Notes: This function is used to get a cursor from the caller's application resource

or from the system resource file. It is functionally equivalent to:

curHand = GetResource('CURS', cursorID );

The following cursors are available in the system resource file with

symbolic names and values defined in Quickdraw.h:

iBeamCursor 1

use for editing text

crossCursor 2

use for paint/draw object manipulation

plusCursor 3

use when awaiting I/O, et.al.

arrow n/a

Note: a global variable, not a resource per se

See Standard Cursors for a more-detailed look. See SetCursor for

related information and examples of usage.

Referenced by (33):