NAME
XGetWMHints − read the window manager hints property.
Synopsis
XWMHints *XGetWMHints(display, w)
Display *display;
Window w;
Arguments
displaySpecifies a connection to an X server; returned from XOpenDisplay().
wSpecifies the ID of the window to be queried.
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 10, 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 DontCareState0
#define NormalState1
#define ZoomState2
#define IconicState3
#define InactiveState4
Errors
BadWindow
See Also
XAllocWMHints(), XGetClassHint(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(), XSetZoomHints(), XSetWMProperties().
Copyright O’Reilly & Assoc. —