NAME
XRaiseWindow − raise a window to the top of the stacking order.
Synopsis
XRaiseWindow(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 raised to the top of the stack.
Description
XRaiseWindow() moves a window to the top of the stacking order among its siblings. 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, while leaving its x and y location on the desk constant. Raising a mapped window may generate exposure events for that window and any mapped subwindows of that window that were formerly obscured. If the override_redirect attribute of the window (see Volume One, 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.
Errors
BadWindow
See Also
XCirculateSubwindows(), XCirculateSubwindowsDown(), XCirculateSubwindowsUp(), XConfigureWindow(), XLowerWindow(), XMoveResizeWindow(), XMoveWindow(), XQueryTree(), XReparentWindow(), XResizeWindow(), XRestackWindows().
Copyright O’Reilly & Assoc. —