DISCUSSION

Although you should generally use the function UpdateControls to update controls, you can use the DrawOneControl function to update a single control. If an embedding hierarchy exists and the control passed in has embedded controls, DrawOneControl draws the control and embedded controls. If the root control for a window is passed in, the result is the same as if DrawControls was called.

VERSION NOTES

Changed with Appearance Manager 1.0 to support embedding hierarchies.

SEE ALSO

Embedding Controls .

DrawControlInCurrentPort

Draws a control in the current graphics port.

pascal void DrawControlInCurrentPort (ControlHandle inControl);

inControl

A handle to the control to draw.

DISCUSSION

Typically, controls are automatically drawn in their owner's graphics port with DrawControls , DrawOneControl , and UpdateControls . DrawControlInCurrentPort permits easy offscreen control drawing and printing. All standard system controls support this function.

VERSION NOTES

Available with Appearance Manager 1.0 and later.

SetUpControlBackground

Sets the background for a control.

pascal OSErr SetUpControlBackground (
                     ControlHandle inControl,
                     SInt16 inDepth,
                     Boolean inIsColorDevice);

inControl

A handle to the control whose background is to be set.

inDepth

The bit depth (in pixels) of the current graphics port.

inIsColorDevice

A Boolean value. 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; see Result Codes .

DISCUSSION

The SetUpControlBackground function allows you to set the background of a control. This function is typically called by control definition functions that are embedded in other controls. You might call SetUpControlBackground in response to an application-defined function installed in a user pane control; see Defining Your Own User Pane Functions . SetUpControlBackground ensures that the background color is always correct when calling EraseRect and EraseRgn . If your control spans multiple monitors, SetUpControlBackground should be called for each device that your control is drawing on; see "Graphics Devices" in Imaging With QuickDraw for more details on handling device loops.

VERSION NOTES

Available with Appearance Manager 1.0 and later.