xsetstandab(3) [hpux man page]
XSetStandardProperties() XSetStandardProperties()
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
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-terminated 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.
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 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 Also
XChangeProperty(), XDeleteProperty(), XGetAtomName(), XGetFontProperty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XRo-
tateWindowProperties().
Xlib - Properties XSetStandardProperties()
Check Out this Related Man Page
XGetZoomHints() XGetZoomHints()
Name
XGetZoomHints - read the size hints property of a zoomed window.
Synopsis
Status XGetZoomHints(display, w, zhints_return)
Display *display;
Window w;
XSizeHints *zhints_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window to be queried.
zhints_return
Returns a pointer to the zoom hints.
Returns
Zero on failure, non-zero on success.
Description
XGetZoomHints() is obsolete beginning in Release 4, because zoom hints are no longer defined in the ICCCM.
XGetZoomHints() is primarily for window managers. XGetZoomHints() returns the size hints for a window in its zoomed state (not normal or
iconified) read from the XA_WM_ZOOM_HINTS property. It returns a non-zero Status if it succeeds, and zero if the application did not spec-
ify zoom size hints for this window.
For more information on using hints, see Volume One, Chapter 12, 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;
} 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 PAllHints (PPosition PSize PMinSize PMaxSize PResizeInc PAspect)
Errors
BadWindow
See Also
XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(),
XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XGetZoomHints()