Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xgetzoomhints(3) [hpux man page]

XGetZoomHints() 														   XGetZoomHints()

Name
  XGetZoomHints - read the size hints property of a zoomed window.

Synopsis
  Status XGetZoomHints(display, w, zhints_return)
	Display *display;
	Window w;
	XSizeHints *zhints_return;

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

  w	   Specifies the ID of the window to be queried.

  zhints_return
	   Returns a pointer to the zoom hints.

Returns
  Zero on failure, non-zero on success.

Description
  XGetZoomHints() is obsolete beginning in Release 4, because zoom hints are no longer defined in the ICCCM.

  XGetZoomHints()  is  primarily for window managers.  XGetZoomHints() returns the size hints for a window in its zoomed state (not normal or
  iconified) read from the XA_WM_ZOOM_HINTS property.  It returns a non-zero Status if it succeeds, and zero if the application did not spec-
  ify zoom size hints for this window.

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

Structures
     typedef struct {
	 long flags;	/* which fields in structure are defined */
	 int x, y;
	 int width, height;
	 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;
     } XSizeHints;

     /* flags argument in size hints */
     #define USPosition  (1L << 0)    /* user specified x, y */
     #define USSize	 (1L << 1)    /* user specified width, height */

     #define PPosition	 (1L << 2)    /* program specified position */
     #define PSize	 (1L << 3)    /* program specified size */
     #define PMinSize	 (1L << 4)    /* program specified minimum size */
     #define PMaxSize	 (1L << 5)    /* program specified maximum size */
     #define PResizeInc  (1L << 6)    /* program specified resize increments */
     #define PAspect	 (1L << 7)    /* program specified min/max aspect ratios */
     #define PAllHints (PPosition PSize PMinSize PMaxSize PResizeInc PAspect)

Errors
  BadWindow

See Also
  XFetchName(),  XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
  XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(),
  XSetZoomHints(), XStoreName().

Xlib - Window Manager Hints													   XGetZoomHints()

Check Out this Related Man Page

XSetWMSizeHints()														 XSetWMSizeHints()

Name
  XSetWMSizeHints - set a window's XA_WM_SIZE_HINTS property.

Synopsis
  void XSetWMSizeHints(display, w, hints, property)
	Display *display;
	Window w;
	XSizeHints *hints;
	Atom property;

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

  w	    Specifies the window.

  hints     Specifies the XSizeHints structure to be used.

  property  Specifies the property name.

Availability
  Release 4 and later.

Description
  XSetWMSizeHints()  sets  the	size  hints  for  the  specified  property  on	the  named  window.   The  property  is stored with a type of
  XA_WM_SIZE_HINTS and a format of 32.	To set a window's normal size hints, you can use the XSetWMNormalHints()  function  instead.  XSetWM-
  SizeHints() supersedes XSetSizeHints().

  This routine is useful if new properties of type XA_WM_SIZE_HINTS are defined.

  The flags member of XSizeHints must be set to the OR of the symbols representing each member to be set.

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

Structures
     typedef struct {
	 long flags;	    /* marks which fields in this structure are */
			    /* defined as */
	 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;

     #define USPosition    (1L << 0)	/* user specified x, y */
     #define USSize	   (1L << 1)	/* user specified width, height */

     #define PPosition	   (1L << 2)	/* program specified position
     */
     #define PSize	   (1L << 3)	/* program specified size */
     #define PMinSize	   (1L << 4)	/* program specified minimum size */
     #define PMaxSize	   (1L << 5)	/* program specified maximum size */
     #define PResizeInc    (1L << 6)	/* program specified resize increments *
     /
     #define PAspect	   (1L << 7)	/* program specified min/max aspect
     ratios */
     #define PAllHints (PPosition PSize PMinSize PMaxSize PResizeInc PAspect)
     #define PBaseSize	   (1L << 8)	/* program specified base for incrementing */
     #define PWinGravity   (1L << 9)	/* program specified window gravity */

Errors
  BadAlloc
  BadAtom
  BadWindow

See Also
  XAllocSizeHints(), XGetWMNormalHints(), XGetWMSizeHints(), XSetWMNormalHints().

Xlib - Window Manager Hints													 XSetWMSizeHints()
Man Page