XWithdrawWindow() XWithdrawWindow()
Name
XWithdrawWindow - request that a top-level window be withdrawn.
Synopsis
Status XWithdrawWindow(display, w, screen_number)
Display *display;
Window w;
int screen_number;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window.
screen_number
Specifies the appropriate screen number on the server.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
Description
XWithdrawWindow() informs the window manager that the specified window and its icon should be unmapped. It unmaps the specified window and
sends a synthetic UnmapNotify event to the root window of the specified screen. Window managers may elect to receive this message and may
treat it as a request to change the window's state to withdrawn. When a window is in the withdrawn state, neither its normal nor its
iconic representation is visible. XWithdrawWindow() returns a non-zero status if the UnmapNotify event is successfully sent; otherwise, it
returns a zero status.
For more information, see Volume One, Chapter 12, Interclient Communication.
Errors
BadWindow
See Also
XIconifyWindow(), XReconfigureWMWindow().
Xlib - Window Manager Hints XWithdrawWindow()
