Copyright (C) 2000-2012 |
Manpages XIconifyWindowSection: XLIB FUNCTIONS (3X11)Updated: Release 6.5 Index Return to Main Contents NAMEXIconifyWindow, XWithdrawWindow, XReconfigureWMWindow - manipulate top-level windowsSYNTAXStatus XIconifyWindow(display, w, screen_number)Display *display; Window w; int screen_number;
Status XWithdrawWindow(display, w, screen_number)
Status XReconfigureWMWindow(display, w, screen_number,
value_mask, values)
ARGUMENTS
DESCRIPTIONThe 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 Conventions Manual) and a window of w to the root window of the specified screen with an event mask set to SubstructureNotifyMask| SubstructureRedirectMask. 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 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. XReconfigureWMWindow can generate BadValue and BadWindow errors. DIAGNOSTICS
SEE ALSOXChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XMapWindow(3X11), XUnmapWindow(3X11)Xlib - C Language X Interface
IndexThis document was created by man2html, using the manual pages. Time: 12:53:59 GMT, April 25, 2024 |