Xlib − C Language X Interface

Xlib − C LibraryX11, Release 6.7 DRAFTXLowerWindow(display, w)Display *display;Window w;displaywSpecifies the connection to the X server.Specifies the window.The XLowerWindow function lowers the specified window tothe bottom of the stack so that itdoes not obscure any sibling windows. If the windows are regarded as overlapping sheets ofpaper stacked on a desk, then lowering a window isanalogous to moving the sheet to the bottomof the stack but leaving its x and y location on the desk constant. Lowering a mapped windowwill generate Expose events on any windows it formerly obscured.If the override-redirect attribute of the window is False and some other client has selected SubstructureRedirectMaskon the parent, the X server generates a ConfigureRequest event, andno processing is performed. Otherwise, the window islowered to the bottom of the stack.XLowerWindow can generate a BadWindow error.To circulate a subwindow upordown, use XCirculateSubwindows.XCirculateSubwindows (display, w, direction)Display *display;Window w;int direction;displaywdirectionSpecifies the connection to the X server.Specifies the window.Specifies the direction (up or down) that you want to circulate the window. Youcan pass RaiseLowest or LowerHighest.The XCirculateSubwindows function circulates children of the specified window inthe specifieddirection. If you specify RaiseLowest, XCirculateSubwindows raises the lowest mappedchild (if any) that is occluded by another child to the top of the stack. If you specify LowerHighest,XCirculateSubwindows lowers the highest mapped child (if any) that occludes anotherchild to the bottom of the stack. Exposure processing is then performed on formerly obscuredwindows. If some other client has selected SubstructureRedirectMask on the window, the Xserver generates a CirculateRequest event, and no further processing is performed. If a child isactually restacked, the X server generates a CirculateNotify event.XCirculateSubwindows can generate BadValue and BadWindow errors.To raise the lowest mapped child of a window that is partially or completely occluded by anotherchild, use XCirculateSubwindowsUp.51