XWithdrawWindow

Syntax

Status XWithdrawWindow(display, w, screen_number)
      Display *display;
      Window w;
      int screen_number;

Arguments

display Specifies the connection to the X server.
w Specifies the window.
screen_number Specifies the appropriate screen number on the host server.

Description

The XWithdrawWindow() function 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 representations is visible. It returns a nonzero status if the UnmapNotify event is successfully sent; otherwise, it returns a zero status.

XWithdrawWindow() can generate a BadWindow error.

Diagnostics

BadWindow A value for a Window argument does not name a defined Window.

See also

XChangeWindowAttributes(), XConfigureWindow(), XCreateWindow(), XDestroyWindow(), XMapWindow(), XRaiseWindow(), XReconfigureWMWindow(), XUnmapWindow(), XWithdrawWindow(), "Manipulating Top-Level Windows".
Christophe Tronche, ch@tronche.com