XSetWMSizeHints()XSetWMSizeHints()NameXSetWMSizeHints – 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.
DescriptionXSetWMSizeHints() 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. XSetWMSizeHints() 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 Communi‐
cation.
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 AlsoXAllocSizeHints(), XGetWMNormalHints(), XGetWMSizeHints(), XSetWMNor‐
malHints().
Xlib - Window Manager Hints XSetWMSizeHints()