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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the window. 

screen_number
Specifies the appropriate screen number on the server.

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 nonzero status if the UnmapNotify event is successfully sent; otherwise, it returns a zero status.  For more information, see Volume One, Chapter 10, Interclient Communication. 

Errors

BadWindow

See Also

XIconifyWindow(), XReconfigureWMWindow(). 

Copyright O’Reilly & Assoc.  —