Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

XSetSizeHints() 														   XSetSizeHints()

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
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies the window ID.

  hints     Specifies a pointer to the size hints.

  property  Specifies 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 prop-
  erties of type XA_WM_SIZE_HINTS are defined.	The predefined properties of that type have their own  set  and  get  functions,  XSetNormal-
  Hints() 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 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;
	 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

See Also
  XFetchName(),  XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
  XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetTransientForHint(), XSetWMHints(),
  XSetZoomHints(), XStoreName().

Xlib - Window Manager Hints													   XSetSizeHints()
Man Page