XIconifyWindow
NAMESYNTAX
ARGUMENTS
DESCRIPTION
DIAGNOSTICS
SEE ALSO
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 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
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
More Linux Commands
manpages/XFocusChangeEvent.3.html
XFocusChangeEvent(3) - FocusIn and FocusOut event structure
The structure for FocusIn and FocusOut events contains: typedef struct { int type; /* FocusIn or FocusOut */ unsigned long serial; /* # of last request processe
manpages/Tk_GetItemTypes.3.html
Tk_GetItemTypes(3) - define new kind of canvas item.........
Tk_CreateItemType is invoked to define a new kind of canvas item described by the typePtr argument. An item type corresponds to a particular value of the type a
manpages/fsck.btrfs.8.html
fsck.btrfs(8) do nothing, successfully - Linux manual page
fsck.btrfs is a type of utility that should exist for any filesystem and is called during system setup when the corresponding /etc/fstab entries contain non-zer
manpages/gnutls_rnd.3.html
gnutls_rnd(3) - API function (Library - Linux man page).....
This function will generate random data and store it to output buffer. RETURNS Zero or a negative error code on error. SINCE 2.12.0 REPORTING BUGS Report bugs t
manpages/systemd-journald.service.8.html
systemd-journald.service(8) Journal service - Linux man page
systemd-journald is a system service that collects and stores logging data. It creates and maintains structured, indexed journals based on logging information t
manpages/pod2usage.1.html
pod2usage(1) - print usage messages from embedded pod docs i
pod2usage will read the given input file looking for pod documentation and will print the corresponding usage message. If no input file is specified then standa
manpages/qmqpd.8.html
qmqpd(8) - Postfix QMQP server (Admin - Linux man page).....
The Postfix QMQP server receives one message per connection. Each message is piped through the cleanup(8) daemon, and is placed into the incoming queue as one s
manpages/phys.2.html
phys(2) unimplemented system calls - Linux manual page......
These system calls are not implemented in the Linux kernel. RETURN VALUE These system calls always return -1 and set errno to ENOSYS. NOTES Note that ftime(3),
manpages/iso-8859-5.7.html
iso-8859-5(7) - ISO 8859-5 character set encoded in octal, d
The ISO 8859 standard includes several 8-bit extensions to the ASCII character set (also known as ISO 646-IRV). ISO 8859-5 encodes the Cyrillic alphabet as used
manpages/clock_gettime.2.html
clock_gettime(2) - clock and time functions - Linux man page
The function clock_getres() finds the resolution (precision) of the specified clock clk_id, and, if res is non-NULL, stores it in the struct timespec pointed to
manpages/Tcl_DeleteFileHandler.3.html
Tcl_DeleteFileHandler(3) - associate procedure callbacks wit
Tcl_CreateFileHandler arranges for proc to be invoked in the future whenever I/O becomes possible on a file or an exceptional condition exists for the file. The
manpages/XML::Parser::Style::Debug.3pm.html
XML::Parser::Style::Debug(3pm) - Debug style for XML::Parser
This just prints out the document in outline form to STDERR . Nothing special is returned by parse. XML::Parser::Style::Debug.3pm (Library - Linux manual page)
