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

NAME

XSetStandardProperties — set the minimum set of properties for the window manager.

SYNOPSIS

XSetStandardProperties(display, w, window_name, icon_name,

icon_pixmap, argv, argc, hints) Display ∗display; Window w; char ∗window_name; char ∗icon_name; Pixmap icon_pixmap; char ∗∗argv; int argc; XSizeHints ∗hints

ARGUMENTS

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

wSpecifies the window ID.

window_name
Specifies the name of the window. Should be a null-terminated string.

icon_nameSpecifies the name to be displayed in the window’s icon. Should be a null-terminated string.

icon_pixmap
Specifies the pixmap that is to be used for the icon, or None. This pixmap must be of depth 1.

argvSpecifies a pointer to the command and arguments used to start the application.

argcSpecifies the number of arguments.

hintsSpecifies a pointer to the size hints for the window in its normal state.

DESCRIPTION

XSetStandardProperties() is superseded by XSetWMProperties() in Release 4.

XSetStandardProperties() sets in a single call the most essential properties for a quickie application. XSetStandardProperties() gives a window manager some information about your program’s preferences; it probably will not be sufficient for complex programs. If the strings are not in the Host Portable Character Encoding, the result is implementation-dependent.

See Volume One, Chapter 10, Interclient Communication for a description of standard properties.

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 and max aspect ratios ∗/ #define PBaseSize (1L << 8) #define PWinGravity (1L << 9) #define PAllHints (PPosition|PSize|PMinSize|PMaxSize|PResizeInc|PAspect)

ERRORS

BadAlloc
BadWindow