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()
