Legacy Document

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.