XSetStandardProperties()XSetStandardProperties()Name
XSetStandardProperties – set the minimum set of properties for the win‐
dow 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
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window ID.
window_name
Specifies the name of the window. Should be a NULL-termi‐
nated string.
icon_name Specifies 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.
argv Specifies a pointer to the command and arguments used to
start the application.
argc Specifies the number of arguments.
hints Specifies a pointer to the size hints for the window in its
normal state.
DescriptionXSetStandardProperties() is superseded by XSetWMProperties() in Release
4.
XSetStandardProperties() sets in a single call the most essential prop‐
erties 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 imple‐
mentation-dependent.
See Volume One, Chapter 12, 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
See AlsoXChangeProperty(), XDeleteProperty(), XGetAtomName(), XGetFontProp‐
erty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XRo‐
tateWindowProperties().
Xlib - Properties XSetStandardProperties()
