Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Imaging With QuickDraw /
Chapter 8 - Cursor Utilities / Cursor Utilities Reference

The Color Cursor Resource

You can use a color cursor resource to define a colored cursor to display in your application. A color cursor resource is a resource of type 'crsr'. All color cursor resources must be marked purgeable and must have resource IDs greater than 128. You use the GetCCursor function (described on page 8-24) to obtain a color cursor stored in a 'crsr' resource. Color QuickDraw reads the requested resource, copies it, and then alters the copy before passing it to the application. Each time you call GetCCursor, you get a new copy of the cursor. This means that you should call GetCCursor only once for a color cursor, even if you call the SetCCursor procedure many times.

This section describes the structure of this resource after it has been compiled by the Rez resource compiler, available from APDA. However, you typically use a high-level utility such as the ResEdit application to create 'crsr' resources. You can then use the DeRez decompiler to convert your 'crsr' resources into Rez input when necessary.

The compiled output format for a 'crsr' resource is illustrated in Figure 8-9.

Figure 8-9 Format of a compiled color cursor ('crsr') resource

The compiled version of a 'crsr' resource contains the following elements:

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996