XSetSizeHints()XSetSizeHints()NameXSetSizeHints – set the value of any property of type XA_WM_SIZE_HINTS.
Synopsis
XSetSizeHints(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 ID.
hints Specifies a pointer to the size hints.
property Specifies the property atom.
DescriptionXSetSizeHints() has been superseded by XSetWMSizeHints() as of Release
4.
XSetSizeHints() sets the named property on the specified window to the
specified XSizeHints structure. This routine is useful if new proper‐
ties of type XA_WM_SIZE_HINTS are defined. The predefined properties
of that type have their own set and get functions, XSetNormalHints()
and XSetZoomHints() (XSetWMHints() in Release 4 and later - zoom hints
are obsolete).
The flags member of XSizeHints must be set to the OR of the symbols
representing each member to be set.
For more information on using hints, see Volume One, Chapter 12, Inter‐
client 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;
int base_width, base_height;
int win_gravity;
} 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 PBaseSize (1L << 8)
#define PWinGravity (1L << 9)
#define PAllHints (PPosition PSize PMinSize PMaxSize PResizeInc PAspect)
Errors
BadAlloc
BadAtom
BadWindow
See AlsoXFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGet‐
NormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetI‐
conSizes(), XSetNormalHints(), XSetTransientForHint(), XSetWMHints(),
XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XSetSizeHints()