Carbon


SetUpControlTextColor

Header: Controls.h Carbon status: Supported

Prepares a control to be drawn with a text color consistent with that of any controls in which it is embedded and with the current theme.

OSErr SetUpControlTextColor (
    ControlRef inControl, 
    SInt16 inDepth, 
    Boolean inIsColorDevice
);
inControl

A handle to the control whose text color is to be set.

inDepth

A value specifying the bit depth (in pixels) of the current graphics port.

inIsColorDevice

Set to true to indicate that you are drawing on a color device. Set to false for a monochrome device.

function result

A result code.

DISCUSSION

Your control definition function may use the SetUpControlTextColor function inside a DeviceLoop drawing procedure to set a control’s text color to coordinate with the current theme. Applications do not typically need to use this function.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)