hpux man page for xgetwmnormalhints

XGetWMNormalHints()													       XGetWMNormalHints()

Name
  XGetWMNormalHints - read a window's XA_WM_NORMAL_HINTS property.

Synopsis
  Status XGetWMNormalHints(display, w, hints_return, supplied_return)
	Display *display;
	Window w;
	XSizeHints *hints_return;
	long *supplied_return;

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

  w	    Specifies the window.

  hints_return
	    Returns the size hints for the window in its normal state.

  supplied_return
	    Returns the hints that were supplied by the user.

Returns
  Zero on failure, non-zero on success.

Availability
  Release 4 and later.

Description
  XGetWMNormalHints()  returns	the size hints stored in the XA_WM_NORMAL_HINTS property on the specified window.  If the property is of type
  XA_WM_SIZE_HINTS, of format 32, and is long enough to contain either an old (pre-ICCCM) or new size  hints  structure,  XGetWMNormalHints()
  sets the various fields of the XSizeHints structure, sets the supplied_return argument to the list of fields that were supplied by the user
  (whether or not they contained defined values) and returns a non-zero status.  XGetWMNormalHints() returns a zero status if the application
  specified no normal size hints for this window.

  XGetWMNormalHints() supersedes XGetNormalHints().

  If XGetWMNormalHints() returns successfully and a pre-ICCCM size hints property is read, the supplied_return argument will contain the fol-
  lowing bits:

     (USPosition USSize PPosition PSize PMinSize PMaxSize PResizeInc PAspect)

  If the property is large enough to contain the base size and window gravity fields as well, the supplied argument  will  also  contain  the
  following bits:

     (PBaseSize PWinGravity)

  This function is normally used only by a window manager.

  For more information, see Volume One, Chapter 12, Interclient Communication.

Structures
     typedef struct {
	 long flags;	    /* marks which fields in this structure are defined */
	 int x, y;	    /* obsolete for new window mgrs, but clients */
	 int width, height; /* should set so old wm's don't mess up */
	 int min_width, min_height;
	 int max_width, max_height;
	 int width_inc, height_inc;
	 struct {
		 int x;     /* numerator */
		 int y;     /* denominator */
	 } min_aspect, max_aspect;
	 int base_width, base_height;	   /* added by ICCCM version 1 */
	 int win_gravity;		   /* added by ICCCM version 1 */
     } XSizeHints;

Errors
  BadWindow

See Also
  XAllocSizeHints(), XGetWMSizeHints(), XSetWMNormalHints(), XSetWMProperties(), XSetWMSizeHints().

Xlib - Window Manager Hints												       XGetWMNormalHints()