hpux man page for xraisewindow

XRaiseWindow()															    XRaiseWindow()

Name
  XRaiseWindow - raise a window to the top of the stacking order.

Synopsis
  XRaiseWindow(display, w)
	Display *display;
	Window w;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies 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().

Xlib - Window Manipulation													    XRaiseWindow()