Carbon


ThemeButtonDrawInfo

Header: Appearance.h

struct ThemeButtonDrawInfo {
    ThemeDrawState state; 
    ThemeButtonValue value; 
    ThemeButtonAdornment adornment;
};
typedef ThemeButtonDrawInfo ThemeButtonDrawInfoPtr;

Field descriptions

state

A value of type ThemeDrawState, specifying the state of the button, such as whether it is active, inactive, or pressed. See “Theme Draw State Constants” for descriptions of possible values.

value

A value of type ThemeButtonValue, specifying the value of the button, such as, in the case of checkbox, whether it is drawn as on, off, or mixed. See “Theme Button Value Constants” for descriptions of possible values.

adornment

A value of type ThemeButtonAdornment, specifying any supplementary characteristics of the button, such as whether it is drawn with a focus ring. See “Theme Button Adornment Constants” for descriptions of possible values.

A ThemeButtonDrawInfo structure describes the changeable visual characteristics of a button. Your application can use a ThemeButtonDrawInfo structure, together with a constant of type ThemeButtonKind, to fully describe the visual characteristics of a given button type at a given point in time. See “Theme Button Kind Constants” for a description of ThemeButtonKind values.

Your application uses the ThemeButtonDrawInfo structure in the function DrawThemeButton to draw a theme-compliant button and in the functions GetThemeButtonRegion and GetThemeButtonContentBounds to obtain information about a specific button type.

VERSION NOTES

The ThemeButtonDrawInfo structure is available with Appearance Manager 1.1 and later.


© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)