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()