XSetStandaB(3x) — HP-UX 9.05

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