XSetWMName()XSetWMName()NameXSetWMName – set a window's XA_WM_NAME property.
Synopsis
void XSetWMName(display, w, text_prop)
Display *display;
Window w;
XTextProperty *text_prop;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window.
text_prop Specifies the XTextProperty structure to be used.
Availability
Release 4 and later.
DescriptionXSetWMName() performs a XSetTextProperty() to set the XA_WM_NAME prop‐
erty on the specified window. XSetWMName() supersedes XStoreName().
This property can also be set with XSetWMProperties().
XSetWMName() should be used 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 visi‐
ble 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 12, Interclient Communi‐
cation.
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;
See AlsoXGetWMIconName(), XGetWMName(), XSetWMIconName(), XSetWMProperties().
Xlib - Window Manager Hints XSetWMName()