WthdrawWind(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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.

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 10, Interclient Communication.

ERRORS

BadWindow

Museum