MirBSD manpage: XCirculateSubwindows(3), XCirculateSubwindowsDown(3), XCirculateSubwindowsUp(3), XLowerWindow(3), XRaiseWindow(3), XRestackWindows(3)


XRaiseWindow(3X11)       XLIB FUNCTIONS        XRaiseWindow(3X11)

NAME

     XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCircula-
     teSubwindowsUp, XCirculateSubwindowsDown, XRestackWindows -
     change window stacking order

SYNTAX

     int XRaiseWindow(Display *display, Window w);

     int XLowerWindow(Display *display, Window w);

     int XCirculateSubwindows(Display *display, Window w, int
          direction);

     int XCirculateSubwindowsUp(Display *display, Window w);

     int XCirculateSubwindowsDown(Display *display, Window w);

     int XRestackWindows(Display *display, Window windows[], int
          nwindows);

ARGUMENTS

     direction Specifies the direction (up or down) that you want
               to circulate the window. You can pass RaiseLowest
               or LowerHighest.

     display   Specifies the connection to the X server.

     nwindows  Specifies the number of windows to be restacked.

     w         Specifies the window.

     windows   Specifies an array containing the windows to be
               restacked.

DESCRIPTION

     The XRaiseWindow function raises the specified window to the
     top of the stack so that no sibling window obscures it. If
     the windows are regarded as overlapping sheets of paper
     stacked on a desk, then raising a window is analogous to
     moving the sheet to the top of the stack but leaving its x
     and y location on the desk constant. Raising a mapped window
     may generate Expose events for the window and any mapped
     subwindows that were formerly obscured.

     If the override-redirect attribute of the window is False
     and some other client has selected SubstructureRedirectMask
     on the parent, the X server generates a ConfigureRequest
     event, and no processing is performed. Otherwise, the window
     is raised.

     XRaiseWindow can generate a BadWindow error.

XFree86                   Version 4.5.0                         1

XRaiseWindow(3X11)       XLIB FUNCTIONS        XRaiseWindow(3X11)

     The XLowerWindow function lowers the specified window to the
     bottom of the stack 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 analo-
     gous to moving the sheet to the bottom of the stack but
     leaving its x and y location on the desk constant. Lowering
     a mapped window will 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 SubstructureRedirectMask
     on the parent, the X server generates a ConfigureRequest
     event, and no processing is performed. Otherwise, the window
     is lowered to the bottom of the stack.

     XLowerWindow can generate a BadWindow error.

     The XCirculateSubwindows function circulates children of the
     specified window in the specified direction. If you specify
     RaiseLowest, XCirculateSubwindows raises the lowest mapped
     child (if any) that is occluded by another child to the top
     of the stack. If you specify LowerHighest, XCirculateSubwin-
     dows lowers the highest mapped child (if any) that occludes
     another child to the bottom of the stack. Exposure process-
     ing is then performed on formerly obscured windows. If some
     other client has selected SubstructureRedirectMask on the
     window, the X server generates a CirculateRequest event, and
     no further processing is performed. If a child is actually
     restacked, the X server generates a CirculateNotify event.

     XCirculateSubwindows can generate BadValue and BadWindow
     errors.

     The XCirculateSubwindowsUp function raises the lowest mapped
     child of the specified window that is partially or com-
     pletely occluded by another child. Completely unobscured
     children are not affected. This is a convenience function
     equivalent to XCirculateSubwindows with RaiseLowest speci-
     fied.

     XCirculateSubwindowsUp can generate a BadWindow error.

     The XCirculateSubwindowsDown function lowers the highest
     mapped child of the specified window that partially or com-
     pletely occludes another child. Completely unobscured chil-
     dren are not affected. This is a convenience function
     equivalent to XCirculateSubwindows with LowerHighest speci-
     fied.

     XCirculateSubwindowsDown can generate a BadWindow error.

XFree86                   Version 4.5.0                         2

XRaiseWindow(3X11)       XLIB FUNCTIONS        XRaiseWindow(3X11)

     The XRestackWindows function restacks the windows in the
     order specified, from top to bottom. The stacking order of
     the first window in the windows array is unaffected, but the
     other windows in the array are stacked underneath the first
     window, in the order of the array. The stacking order of the
     other windows is not affected. For each window in the window
     array that is not a child of the specified window, a Bad-
     Match error results.

     If the override-redirect attribute of a window is False and
     some other client has selected SubstructureRedirectMask on
     the parent, the X server generates ConfigureRequest events
     for each window whose override-redirect flag is not set, and
     no further processing is performed. Otherwise, the windows
     will be restacked in top-to-bottom order.

     XRestackWindows can generate BadWindow error.

DIAGNOSTICS

     BadValue  Some numeric value falls outside the range of
               values accepted by the request. Unless a specific
               range is specified for an argument, the full range
               defined by the argument's type is accepted.  Any
               argument defined as a set of alternatives can gen-
               erate this error.

     BadWindow A value for a Window argument does not name a
               defined Window.

SEE ALSO

     XChangeWindowAttributes(3X11), XConfigureWindow(3X11),
     XCreateWindow(3X11), XDestroyWindow(3X11), XMapWindow(3X11),
     XUnmapWindow(3X11)
     Xlib - C Language X Interface

XFree86                   Version 4.5.0                         3

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.