StSizeHints(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

NAME

XSetSizeHints — 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

displaySpecifies a connection to an X server; returned from XOpenDisplay().

wSpecifies the window ID.

hintsSpecifies a pointer to the size hints.

propertySpecifies the property atom.

DESCRIPTION

XSetSizeHints() 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 properties 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 10, 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;
    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