XMapWindow()XMapWindow()NameXMapWindow – map a window.
Synopsis
XMapWindow(display, w)
Display *display;
Window w;
Arguments
display Specifies a connection to an X server; returned from XOpenDis‐
play().
w Specifies the ID of the window to be mapped.
DescriptionXMapWindow() 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 AlsoXMapRaised(), XMapSubwindows(), XUnmapSubwindows(), XUnmapWindow().
Xlib - Window Mapping XMapWindow()
