|
|
pekwm 0.1.10 (Default branch)
01-26-2009
|
|
XGetWMHints() XGetWMHints()
Name
XGetWMHints - read the window manager hints property.
Synopsis
XWMHints *XGetWMHints(display, w)
Display *display;
Window w;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window to be queried.
Returns
The window manager hints structure.
Description
This function is primarily for window managers. XGetWMHints() returns NULL if no XA_WM_HINTS property was set on window w, and returns a
pointer to an XWMHints structure if it succeeds. Programs must free the space used for that structure by calling XFree().
For more information on using hints, see Volume One, Chapter 12, Interclient Communication.
Structures
typedef struct {
long flags; /* marks which fields in this structure are defined */
Bool input; /* does application need window manager for input */
int initial_state; /* see below */
Pixmap icon_pixmap; /* pixmap to be used as icon */
Window icon_window; /* window to be used as icon */
int icon_x, icon_y; /* initial position of icon */
Pixmap icon_mask; /* icon mask bitmap */
XID window_group; /* ID of related window group */
/* this structure may be extended in the future */
} XWMHints;
/* initial state flag: */
#define DontCareState 0
#define NormalState 1
#define ZoomState 2
#define IconicState 3
#define InactiveState 4
Errors
BadWindow
See Also
XAllocWMHints(), XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransient-
ForHint(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTran-
sientForHint(), XSetWMHints(), XSetZoomHints(), XStoreName(), XSetWMProperties().
Xlib - Window Manager Hints XGetWMHints()