NAME

XStoreName — assign a name to a window for the window manager. 

SYNOPSIS

XStoreName(display, w, window_name) Display ∗display; Window w; char ∗window_name;

ARGUMENTS

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

wSpecifies the ID of the window to which you want to assign a name. 

window_name
Specifies the name of the window. The name should be a null-terminated string. If the string is not in the Host Portable Character Encoding, the result is implementation-dependent. This name is returned by any subsequent call to XFetchName(). 

DESCRIPTION

XStoreName() is superseded in Release 4 by XSetWMName(). 

XStoreName() sets the XA_WM_NAME property, which should be used by the application to communicate the following information to the window manager, according to current conventions:

•To permit the user to identify one of a number of instances of the same client. 

•To 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. 

ERRORS

BadAlloc
BadWindow

SEE ALSO

XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(),

Xlib Reference Manual