Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Manipulating the Desktop

SetDeskCPat

Use the SetDeskCPat procedure to set the desktop pattern on a computer that supports Color QuickDraw.

PROCEDURE SetDeskCPat (deskPixPat: PixPatHandle);

deskPixPat

A handle to a pixel pattern.

DESCRIPTION

The SetDeskCPat procedure sets the desktop pattern to a specified pixel pattern, which can be drawn in more than two colors. After a call to SetDeskCPat, the desktop is automatically redrawn in the new pattern. If the specified pattern is a binary pattern (with a pattern type of 0), it is drawn is the current foreground and background colors. If the value of the deskPixPat parameter is NIL, SetDeskCPat uses the standard binary desk pattern (that is, the 'ppat' resource with resource ID 16).

Note

For compatibility with other Macintosh applications and the
system software, applications should ordinarily not change the
desktop pattern.

The Window Manager's desktop-painting routines can paint the desktop either in the binary pattern stored in the global variable DeskPattern or in a new pixel pattern. The desktop pattern used at startup is determined by the value of the parameter-RAM bit flag called pCDeskPat. If the value of pCDeskPat is 0, the Window Manager uses the new pixel pattern; if not, it uses the binary pattern stored in DeskPattern. The user can change the color pattern through the General Controls panel, which changes the value
of pCDeskPat.