Carbon


Group Box Control Definition IDs

Header: ControlDefinitions.h

enum {
    kControlGroupBoxTextTitleProc = 160,
    kControlGroupBoxCheckBoxProc = 161,
    kControlGroupBoxPopupButtonProc = 162,
    kControlGroupBoxSecondaryTextTitleProc = 164,
    kControlGroupBoxSecondaryCheckBoxProc = 165,
    kControlGroupBoxSecondaryPopupButtonProc = 166
};

Constant descriptions

kControlGroupBoxTextTitleProc

Resource ID: 10

Primary group box with text title. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlGroupBoxCheckBoxProc

Resource ID: 10

Primary group box with checkbox title. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlGroupBoxPopupButtonProc

Resource ID: 10

Primary group box with pop-up button title. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlGroupBoxSecondaryTextTitleProc

Resource ID: 10

Secondary group box with text title. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlGroupBoxSecondaryCheckBoxProc

Resource ID: 10

Secondary group box with checkbox title. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlGroupBoxSecondaryPopupButtonProc

Resource ID: 10

Secondary group box with pop-up button title. 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)