SetWindowContentPattern

Sets the pattern to which a window's content region is redrawn.

pascal OSStatus SetWindowContentPattern (
                     WindowPtr window,
                     PixPatHandle pixPat);
window
A value of type WindowPtr . Pass a pointer to the window whose content pattern is being set.
pixPat
A handle to a structure of type PixPat . Before calling SetWindowContentPattern , set this structure to specify the content pattern to be used. This handle is copied by the Window Manager, and your application continues to own the original. Therefore there may be higher RAM requirements for applications with numerous identically patterned windows.
function result
A result code. See Result Codes.
DISCUSSION

If your application uses the SetWindowContentPattern function, the window's content region is redrawn to the pattern you specify, without affecting the value specified in the window's CGrafPort structure for the current background pattern. See Drawing in a Window's Content Region for further discussion and an example of calling the related function SetWindowContentColor .

VERSION NOTES

Available with Mac OS 8.5 and later.

SEE ALSO

The function GetWindowContentPattern .


� 1999 Apple Computer, Inc. – (Last Updated 18 March 99)