hpux man page for xsetwmhints

XSetWMHints()															     XSetWMHints()

Name
  XSetWMHints - set a window manager hints property.

Synopsis
  XSetWMHints(display, w, wmhints)
	Display *display;
	Window w;
	XWMHints *wmhints;

Arguments
  display  Specifies a connection to an X server; returned from XOpenDisplay().

  w	   Specifies the ID for which window manager hints are to be set.

  wmhints  Specifies a pointer to the window manager hints.

Description
  XSetWMHints()  sets  the  window manager hints that include icon information and location, the initial state of the window, and whether the
  application relies on the window manager to get keyboard input.

  This function is unnecessary in Release 4 and later if you call XSetWMProperties().

  See Volume One, Chapter 12, Interclient Communication, for a description of each XWMHints structure member.

Structures
     typedef struct {
	 long flags;	       /* marks defined fields in structure */
	 Bool input;	       /* does application need window manager for
				* keyboard 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;

     /* definitions for the flags field: */
     #define InputHint	      (1L << 0)
     #define StateHint	      (1L << 1)
     #define IconPixmapHint   (1L << 2)
     #define IconWindowHint   (1L << 3)
     #define IconPositionHint (1L << 4)
     #define IconMaskHint     (1L << 5)
     #define WindowGroupHint  (1L << 6)
     #define AllHints (InputHint StateHint IconPixmapHint IconWindowHint  
	 IconPositionHint IconMaskHint WindowGroupHint)

     /* definitions for the initial state flag: */
     #define WithdrawnState   0    /* application would like to be unmapped */
     #define NormalState      1    /* most applications want to start this way */
     #define IconicState      3    /* application wants to start as an icon */

Errors
  BadAlloc
  BadWindow

See Also
  XAllocWMHints(),  XFetchName(),  XGetClassHint(),  XGetIconName(),  XGetIconSizes(),	XGetNormalHints(),  XGetSizeHints(),   XGetTransient-
  ForHint(),  XGetWMHints(),  XGetZoomHints(), XSetClassHint(), XSetCommand().	XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSize-
  Hints(), XSetTransientForHint(), XSetZoomHints(), XStoreName(), XSetWMProperties().

Xlib - Window Manager Hints													     XSetWMHints()