XRaiseWindow
Syntax
XRaiseWindow(display, w)
Display *display;
Window w;
Arguments
| display
| Specifies the connection to the X server.
|
| w
| Specifies the window.
|
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.
Diagnostics
| BadWindow
| A value for a Window argument does not name a defined Window.
|
See also
XChangeWindowAttributes(),
XCirculateSubwindows(),
XCirculateSubwindowsDown(),
XCirculateSubwindowsUp(),
XConfigureWindow(),
XCreateWindow(),
XDestroyWindow(),
XLowerWindow(),
XMapWindow(),
XRestackWindows(),
"Changing Window Stacking Order"
Christophe Tronche, ch@tronche.com