XSetStandardProperties(3X11)

Name

XSetStandardProperties − set standard window manager properties

Syntax

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

argcSpecifies the number of arguments.

argvSpecifies the application’s argument list.

displaySpecifies the connection to the X server.

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

icon_nameSpecifies the icon name, which should be a null-terminated string.

icon_pixmapSpecifies the bitmap that is to be used for the icon or None.

wSpecifies the window.

window_name
Specifies the window name, which should be a null-terminated string.

Description

The XSetStandardProperties function provides a means by which simple applications set the most essential properties with a single call. XSetStandardProperties should be used to give a window manager some information about your program’s preferences. It should not be used by applications that need to communicate more information than is possible with XSetStandardProperties. (Typically, argv is the argv array of your main program.)

XSetStandardProperties can generate BadAlloc and BadWindow errors.

Properties

WM_NAME, WM_ICON_NAME, WM_HINTS, WM_COMMAND, and WM_NORMALHINTS

Diagnostics

BadAlloc The server failed to allocate the requested resource or server memory.

BadWindow
A value for a Window argument does not name a defined Window.

Museum

Related Articles