XSetWMName(3x) — HPUX 9.05

NAME

Synopsis

   Display *display;
   Window w;
   XTextProperty *text_prop;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay().

wSpecifies the window.

text_propSpecifies the XTextProperty structure to be used.

Availability

Release 4 and later.

Description

performs a XSetTextProperty() to set the XA_WM_NAME property on the specified window. also be set with XSetWMProperties(). by the application to communicate a string to the window manager. According to current conventions, this string should either:

•permit the user to identify one of a number of instances of the same client, or

•provide the user with noncritical state information. Clients can assume that at least the beginning of this string is visible to the user. The XA_WM_CLASS property, on the other hand, has two members which should be used to identify the application’s instance and class name, for the lookup of resources. See XSetClassHint() for details. For more information, see Volume One, Chapter 10, Interclient Communication.

Structures

typedef struct {
    unsigned char *value;          /* same as Property routines */
    Atom encoding;                 /* prop type */
    int format;                    /* prop data format: 8, 16, or 32 */
    unsigned long nitems;          /* number of data items in value */
} XTextProperty;