xsetwmnormalhints(3) [hpux man page]
XSetWMNormalHints() XSetWMNormalHints()
Name
XSetWMNormalHints - set a window's XA_WM_NORMAL_HINTS property.
Synopsis
void XSetWMNormalHints(display, w, hints)
Display *display;
Window w;
XSizeHints *hints;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window.
hints Specifies the size hints for the window in its normal state.
Availability
Release 4 and later.
Description
XSetWMNormalHints() sets the size hints in the XA_WM_NORMAL_HINTS property on the specified window. The property is stored with a type of
WM_SIZE_HINTS and a format of 32. XSetWMNormalHints() supersedes XSetNormalHints(). This property can also be set with XSetWMProper-
ties().
Applications use XSetNormalHints() to inform the window manager of the sizes desirable for that window.
To set size hints, an application must assign values to the appropriate elements in the hints structure, and also set the flags field of
the structure to indicate which members have assigned values and the source of the assignment. These flags are listed in the Structures
section below.
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;
#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
BadWindow
See Also
XGetWMNormalHints(), XSetWMProperties(), XSetWMSizeHints(), XGetWMSizeHints().
Xlib - Window Manager Hints XSetWMNormalHints()
Check Out this Related Man Page
XGetWMSizeHints() XGetWMSizeHints()
Name
XGetWMSizeHints - read a window's XA_WM_SIZE_HINTS property.
Synopsis
Status XGetWMSizeHints(display, w, hints_return, supplied_return, property)
Display *display;
Window w;
XSizeHints *hints_return;
long *supplied_return;
Atom property;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window.
hints_return
Returns the XSizeHints structure.
supplied_return
Returns the hints that were supplied by the user.
property Specifies the property name.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
Description
XGetWMSizeHints() returns the size hints stored in the specified property on the named 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, XGetWMSizeHints() 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. If the hint was not set, it returns a zero status. To get
a window's normal size hints, you can use the XGetWMNormalHints() function instead.
XGetWMSizeHints() supersedes XGetSizeHints().
If XGetWMSizeHints() 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 used almost exclusively by window managers.
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
BadAtom
BadWindow
See Also
XAllocSizeHints(), XGetWMNormalHints(), XSetWMNormalHints(), XSetWMSizeHints().
Xlib - Window Manager Hints XGetWMSizeHints()