Legacy Documentclose button

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

PATHDocumentation > Mac OS 8 and 9 > Human Interface Toolbox > Control Manager >

Mac OS 8 Control Manager Reference

Bevel Button and Image Well Content Type Constants

You can use constants of type ControlContentType in the contentType field of the ControlButtonContentInfo structure to display various kinds of bevel button and image well content, including text, icons, and pictures. The ControlContentType constants are available with Appearance Manager 1.0 and later, except as noted.

The resource IDs for icon suite, color icon, and picture resources are passed in the maximumValue parameter of NewControl or in a control resource; see 'CNTL' . The content type is passed in the low byte of the minimumValue parameter of NewControl .

Note

Resource-based content is owned by the control, while handle-based content is owned by you. The control definition function will not dispose of handle-based content. If you replace handle-based content with resource-based content on the fly, you must dispose of the handle properly to avoid a memory leak.

enum {
    kControlContentTextOnly         = 0,
    kControlContentIconSuiteRes     = 1,
    kControlContentCIconRes         = 2,
    kControlContentPictRes          = 3,
    kControlContentIconSuiteHandle  = 129,
    kControlContentCIconHandle      = 130,
    kControlContentPictHandle       = 131,
    kControlContentIconRef          = 132
};
typedef SInt16 ControlContentType;

Constant descriptions

kControlContentTextOnly
Content type is text. This constant is passed in the contentType field of the ControlButtonContentInfo structure if the content is text only. The variation code kControlUsesOwningWindowsFontVariant applies when text content is used.
kControlContentIconSuiteRes
Content type uses an icon suite resource ID. The resource ID of the icon suite resource you wish to display should be in the resID field of the ControlButtonContentInfo structure.
kControlContentCIconRes
Content type is a color icon resource ID. The resource ID of the color icon resource you wish to display should be in the resID field of the ControlButtonContentInfo structure.
kControlContentPictRes
Content type is a picture resource ID. The resource ID of the picture resource you wish to display should be in the resID field of the ControlButtonContentInfo structure.
kControlContentIconSuiteHandle
Content type is an icon suite handle. The handle of the icon suite you wish to display should be in the iconSuite field of the ControlButtonContentInfo structure.
kControlContentCIconHandle
Content type uses a color icon handle. The handle of the color icon you wish to display should be in the cIconHandle field of the ControlButtonContentInfo structure.
kControlContentPictHandle
Content type uses a picture handle. The handle of the picture you wish to display should be in the picture field of the ControlButtonContentInfo structure.
kControlContentIconRef
Content type is IconRef . An IconRef value for the icon you wish to display should be provided in the iconRef field of the ControlButtonContentInfo structure. Note that the kControlBevelButtonGraphicOffsetTag control data tag constant should not be used with IconRef based bevel button content, because IconRef based icons may change with a theme switch; see Control Data Tag Constants . Supported with Mac OS 8.5 and later.
\xA9 1998 Apple Computer, Inc. – (Last Updated 19 Nov 98)