Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Setting and Retrieving Other Window Characteristics

SetWindowPic

Use the SetWindowPic procedure to establish a picture that the Window Manager can draw in a window's content region.

PROCEDURE SetWindowPic (theWindow: WindowPtr;
                        Pic: PicHandle);

theWindow

A pointer to a window's window record.

Pic

A handle to the picture to be drawn in the window.

DESCRIPTION

The SetWindowPic procedure stores in a window's window record a handle to a picture to be drawn in the window. When the window's content region must be updated, the Window Manager then draws the picture or part of the picture, as necessary, instead of generating an update event.

Note

The CloseWindow and DisposeWindow procedures assume that any picture pointed to by the window record field windowPic is stored as data, not as a resource. If your application uses a picture stored as a resource, you must release the memory it occupies by calling the Resource Manager's ReleaseResource procedure and set the WindowPic field to NIL before you close the window.