XIconifyWindow(3X11) X11R5 XIconifyWindow(3X11)NAME
XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow - manipulate top-
level windows
SYNTAX
Status XIconifyWindow(display, w, screen_number)
Display *display;
Window w;
int screen_number;
Status XWithdrawWindow(display, w, screen_number)
Display *display;
Window w;
int screen_number;
Status XReconfigureWMWindow(display, w, screen_number, value_mask, val‐
ues)
Display *display;
Window w;
int screen_number;
unsigned int value_mask;
XWindowChanges *values;
ARGUMENTS
display Specifies the connection to the X server.
screen_number
Specifies the appropriate screen number on the host server.
value_mask
Specifies which values are to be set using information in the
values structure. This mask is the bitwise inclusive OR of
the valid configure window values bits.
values Specifies the structure.
w Specifies the window.
DESCRIPTION
The function sends a WM_CHANGE_STATE event with a format of 32 and a
first data element of (as described in section 4.1.4 of the Inter-
Client Communication Conventions Manual) and a window of w to the root
window of the specified screen with an event mask set to Window man‐
agers may elect to receive this message and if the window is in its
normal state, may treat it as a request to change the window's state
from normal to iconic. If the WM_CHANGE_STATE property cannot be
interned, does not send a message and returns a zero status. It
returns a nonzero status if the client message is sent successfully;
otherwise, it returns a zero status.
The function unmaps the specified window and sends a synthetic 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 win‐
dow'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 event is successfully sent; otherwise,
it returns a zero status.
can generate a error.
The function issues a request on the specified top-level window. If
the stacking mode is changed and the request fails with a error, the
error is trapped by Xlib and a synthetic containing the same configura‐
tion parameters is sent to the root of the specified window. Window
managers may elect to receive this event and treat it as a request to
reconfigure the indicated window. It returns a nonzero status if the
request or event is successfully sent; otherwise, it returns a zero
status.
can generate and errors.
DIAGNOSTICS
Some numeric value falls outside the range of values accepted by the
request.
Unless a specific range is specified for an argument, the
full range defined by the argument's type is accepted. Any
argument defined as a set of alternatives can generate this
error.
A value for a Window argument does not name a defined Window.
SEE ALSOXChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWin‐
dow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XMapWindow(3X11),
XUnmapWindow(3X11)
Xlib - C Language X Interface
XIconifyWindow(3X11)