SYNTAX

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

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

       Status XReconfigureWMWindow(Display *display, Window w, int screen_num-
              ber, 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 XWindowChanges structure.

       w         Specifies the window.

DESCRIPTION

       The XIconifyWindow function sends a WM_CHANGE_STATE ClientMessage event
       with a format of 32 and a first data element of IconicState (as
       described in section 4.1.4 of the Inter-Client Communication Conven-
       tions Manual) and a window of w to the root window of the specified
       screen with an event mask set to SubstructureNotifyMask| Substructur-
       eRedirectMask.  Window managers 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, XIconifyWindow 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 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.

       The XReconfigureWMWindow function issues a ConfigureWindow request on
       the specified top-level window.  If the stacking mode is changed and
       the request fails with a BadMatch error, the error is trapped by Xlib
       and a synthetic ConfigureRequestEvent containing the same configuration

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

SEE ALSO

       XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWin-
       dow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XMapWindow(3X11),
       XUnmapWindow(3X11)
       Xlib - C Language X Interface



X Version 11                      Release 6.6             XIconifyWindow(3X11)