NAME
XMapWindow − map a window.
Synopsis
XMapWindow(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 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 exposure 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().
Copyright O’Reilly & Assoc. —