Carbon


ControlApplyTextColorRec

Header: Controls.h

struct ControlApplyTextColorRec {
    SInt16 depth; 
    Boolean colorDevice; 
    Boolean active;
};
typedef ControlApplyTextColorRec ControlApplyTextColorPtr;

Field descriptions

depth

The Control Manager sets this field to specify the bit depth (in pixels) of the current graphics port.

colorDevice

The Control Manager passes a value of true if you are drawing on a color device; otherwise, false.

active

The Control Manager passes a value of true to specify a color suitable for active text; otherwise, false.

If you implement a custom control definition function, when the Control Manager passes the message kControlMsgApplyTextColor in your control definition function’s message parameter, it also passes a pointer to a structure of type ControlApplyTextColorRec in the param parameter. The Control Manager sets the ControlApplyTextColorRec structure to contain data describing the current drawing environment, and your control definition function is responsible for using that data to apply the proper text color to the current graphics port.

See “Control Definition Message Constants” for more details on the kControlMsgApplyTextColor message.


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