hpux man page for xmapwindow

XMapWindow()															      XMapWindow()

Name
  XMapWindow - map a window.

Synopsis
  XMapWindow(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 mapped.

Description
  XMapWindow() maps a window, making it eligible for display.  Whether it becomes visible immediately depends on its stacking order among its
  siblings, the mapping status of its ancestors, and the placement of other visible windows.  If all the ancestors are mapped, and it is  not
  obscured by siblings higher in the stacking order, and it is not obscured by unrelated windows (children of ancestors), then the window and
  all of its mapped subwindows are displayed.

  Mapping a window that has an unmapped ancestor does not display the window but marks it as eligible for display when its  ancestors  become
  mapped.  Mapping an already mapped window has no effect (it does not raise the window).

  If the window becomes viewable and no earlier contents for it are remembered (because of backing store), the X server tiles the window with
  its background.  If the window's background is undefined, the existing screen contents are not altered, and the X server generates zero  or
  more	Expose events.	If backing-store was maintained while the window was unmapped, no Expose events are generated.	If backing-store will
  now be maintained, a full-window exposure is always generated.  Otherwise, only visible regions may be reported.  Similar tiling and	expo-
  sure take place for any newly viewable inferiors.

  Note	that for a top-level window, the window manager is likely to intervene and delay the mapping of the window.  The application must not
  draw until it has received an Expose event on the window.  If the window is an InputOutput window, XMapWindow() generates Expose events  on
  each	opaque	window	that  it  causes  to become displayed.	The client should call XSelectInput() for exposure events, then map, and then
  process input events.  The client's normal response to an Expose event should be to repaint the window.  If you fail to wait for the Expose
  event before drawing, the drawing may not appear in the window.

Errors
  BadWindow

See Also
  XMapRaised(), XMapSubwindows(), XUnmapSubwindows(), XUnmapWindow().

Xlib - Window Mapping														      XMapWindow()