Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Manipulating the Desktop

GetGrayRgn
Use the GetGrayRgn function to retrieve a handle to the current desktop region.
FUNCTION GetGrayRgn: RgnHandle;
DESCRIPTION
The GetGrayRgn function returns a handle to the current desktop region from the global variable GrayRgn.
The desktop region represents all available screen space, that is, the desktop area displayed by all monitors attached to the computer. Ordinarily, your application
doesn't need to access the desktop region directly.
When your application calls DragWindow to let the user drag a window, it can use GetGrayRgn to set the limiting rectangle to the entire desktop area.

SEE ALSO
See Listing 4-9 on page 4-44 for an example that uses GetGrayRgn to specify the limiting rectangle when calling DragWindow to let the user move a window.