Carbon


Icon Control Definition IDs

Header: ControlDefinitions.h

enum {
    kControlIconProc = 320,
    kControlIconNoTrackProc = 321,
    kControlIconSuiteProc = 322,
    kControlIconSuiteNoTrackProc = 323
};

Constant descriptions

kControlIconProc

Resource ID: 20

Icon control. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlIconNoTrackProc

Resource ID: 20

Non-tracking icon. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlIconSuiteProc

Resource ID: 20

Icon suite. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlIconSuiteNoTrackProc

Resource ID: 20

Non-tracking icon suite. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

When creating a control, your application supplies a control definition ID to one of the Control Manager control-creation functions or to the control resource; see 'CNTL'. The control definition ID indicates the type of control to create. A control definition ID is an integer that contains the resource ID of a control definition function in its upper 12 bits and a variation code in its lower 4 bits. A control definition ID is derived as follows:

control definition ID = 16 * ('CDEF' resource ID) + variation code

A control definition function determines how a control generally looks and behaves. Control definition functions are stored as resources of type 'CDEF'. Various Control Manager functions call a control definition function whenever they need to perform some control-dependent action, such as drawing the control on the screen. For more information on how to create a control definition function, see ControlDefProcPtr.

A control definition function, in turn, can use a variation code to describe variations of the same basic control. For example, all pop-up arrows share the same basic control definition function, which is stored in a resource of type 'CDEF' and has a resource ID of 12. The standard pop-up arrow is large and points to the right; it has a control definition ID of 192. A variation of this is a large, left-pointing arrow, which has a control definition ID of 193. Still another variation, in which the arrow points up, has a control definition ID of 194.

Your application can use the constants listed here in place of control definition IDs.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)