Carbon


ControlButtonContentInfo

Header: Controls.h

struct ControlButtonContentInfo {
    ControlContentType contentType; 
    union {
          SInt16 resID; 
      CIconHandle cIconHandle; 
      Handle iconSuite; 
      IconRef iconRef; 
      PicHandle picture; 
      Handle ICONHandle;
    } u;
};
typedef ControlButtonContentInfo ControlButtonContentInfoPtr;

Field descriptions

contentType

Specifies the bevel button or image well content type and whether the content is text-only, resource-based, or handle-based; see “Bevel Button and Image Well Content Type Constants”. The value specified in the contentType field determines which of the other fields in the structure are used.

resID

If the content type specified in the contentType field is kControlContentIconSuiteRes, kControlContentCIconRes, or kControlContentPictRes, this field contains the resource ID of a picture, color icon, or icon suite resource.

cIconHandle

If the content type specified in the contentType field is kControlContentCIconHandle, this field contains a handle to a color icon.

iconSuite

If the content type specified in the contentType field is kControlContentIconSuiteHandle, this field contains a handle to an icon suite.

iconRef

If the content type specified in the contentType field is kControlContentIconRef, this field contains an IconRef value. IconRef values are supported under Mac OS 8.5 and later.

picture

If the content type specified in the contentType field is kControlContentPictHandle, this field contains a handle to a picture.

ICONHandle

You can use the ControlButtonContentInfo structure to specify the content for a bevel button or image well. Values of type ControlButtonContentInfo are set via SetControlData and obtained from GetControlData, in conjunction with the kControlBevelButtonContentTag and kControlImageWellContentTag constants; see “Bevel Button Control Data Tag Constants” and “Image Well Control Data Tag Constants”.

VERSION NOTES

The ControlButtonContentInfo type is available with Appearance Manager 1.0 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)