Unix/Linux Go Back    


CentOS 7.0 - man page for xreconfigurewmwindow (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


XIconifyWindow(3)			  XLIB FUNCTIONS			XIconifyWindow(3)

NAME
       XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow - manipulate top-level windows

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_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 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 Conventions Manual) and a window of w to the root window of the spec-
       ified 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 suc-
       cessfully; 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 man-
       agers may elect to receive this event and treat it as a request to reconfigure the indi-
       cated 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
       BadValue  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.

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

SEE ALSO
       XChangeWindowAttributes(3), XConfigureWindow(3), XCreateWindow(3), XDestroyWindow(3),
       XRaiseWindow(3), XMapWindow(3), XUnmapWindow(3)
       Xlib - C Language X Interface

X Version 11				   libX11 1.6.0 			XIconifyWindow(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:44 AM.