Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 4 - Color QuickDraw / Color QuickDraw Reference

Color QuickDraw Routines / Determining Current Colors and Best Intermediate Colors

GetBackColor

Use the GetBackColor procedure to obtain the background color of the current graphics port.

PROCEDURE GetBackColor (VAR color: RGBColor);

color

An RGBColor record.

DESCRIPTION

In the color parameter, the GetBackColor procedure returns the RGBColor record for the background color of the current graphics port. This procedure operates for graphics ports defined by both the GrafPort and CGrafPort records. If the current graphics port is defined by a CGrafPort record, the returned value is taken directly from the rgbBkColor field.

If the current graphics port is defined by a GrafPort record, then only eight possible colors can be returned. These eight colors are determined by the values in a global variable named QDColors, which is a handle to a color table containing the current QuickDraw colors. These colors are listed in Table 4-4 on page 4-62.

SPECIAL CONSIDERATIONS

This procedure is available for basic QuickDraw only in System 7.

SEE ALSO

You can use the RGBBackColor procedure, described on page 4-63, to change the background color.