NAME

XLowerWindow — lower a window in the stacking order. 

SYNOPSIS

XLowerWindow(display, w) Display ∗display; Window w;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the ID of the window to be lowered. 

DESCRIPTION

XLowerWindow() lowers a window in the stacking order of its siblings so that it does not obscure any sibling windows.  If the windows are regarded as overlapping sheets of paper stacked on a desk, then lowering a window is analogous to moving the sheet to the bottom of the stack, while leaving its x and y location on the desk constant.  Lowering a mapped window will generate exposure events on any windows it formerly obscured. 

If the override_redirect attribute of the window (see Chapter 4, Window Attributes) is False and the window manager has selected SubstructureRedirectMask on the parent, then a ConfigureRequest event is sent to the window manager, and no further processing is performed.  Otherwise, the window is lowered to the bottom of the stack. 

LeaveNotify events are sent to the lowered window if the pointer was inside it, and EnterNotify events are sent to the window which was immediately below the lowered window at the pointer position. 

For more information, see Volume One, Chapter 14, Window Management. 

ERRORS

BadWindow

SEE ALSO

XCirculateSubwindows(), XCirculateSubwindowsDown(), XCirculateSubwindowsUp(), XConfigureWindow(), XMoveResizeWindow(), XMoveWindow(), XQueryTree(), XRaiseWindow(), XReparentWindow(), XResizeWindow(), XRestackWindows(). 

Xlib Reference Manual