Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Displaying Windows

SendBehind

Use the SendBehind procedure to move one window behind another.

PROCEDURE SendBehind (theWindow, behindWindow: WindowPtr);

theWindow

A pointer to the window to be moved.

behindWindow

A pointer to the window that is to be in front of the moved window.

DESCRIPTION

The SendBehind procedure moves the window pointed to by the parameter theWindow behind the window pointed to by the parameter behindWindow. If the move exposes previously obscured windows or parts of windows, SendBehind redraws the frames as necessary and generates the appropriate update events to
have any newly exposed content areas redrawn.

If the value of behindWindow is NIL, SendBehind sends the window to be moved behind all other windows on the desktop. If the window to be moved is the active window, SendBehind removes its highlighting, highlights the newly exposed frontmost window, and generates the appropriate activate events.

Note

Do not use SendBehind to deactivate a window after you've made a new window active with the SelectWindow procedure. The SelectWindow procedure automatically deactivates the previously active window.