![]() |
GetThemeBrushAsColor |
||||
Header: | Appearance.h | Carbon status: | Supported | |
Obtains the color that corresponds to a given theme brush type under the current theme.
OSStatus GetThemeBrushAsColor ( ThemeBrush inBrush, SInt16 inDepth, Boolean inColorDev, RGBColor *outColor );
A value of type ThemeBrush. Pass a constant specifying the theme brush type for which you wish to obtain a color; see
A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.
A value of type Boolean. Pass true to indicate that you are drawing on a color device. Pass false for a monochrome device.
A pointer to a structure of type RGBColor. On return, the structure contains a color corresponding to the color or pattern used by the specified theme brush under the current theme.
A result code.
The GetThemeBrushAsColor function obtains a color that corresponds to that which is in use for a specified theme brush. If, in the current theme, the specified brush draws with a pattern instead of a color, a theme-specified approximate color is obtained. Your application should call GetThemeBrushAsColor only when you must use an RGBColor value for a specific operation; typically, your application should call the functions SetThemeBackground and SetThemePen for greatest fidelity with the current theme.
This function is available with Appearance Manager 1.1 and later.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)