Query: xstorename
OS: hpux
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
XStoreName() XStoreName() 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 display Specifies a connection to an X server; returned from XOpenDisplay(). w Specifies 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 Char- acter 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: o To permit the user to identify one of a number of instances of the same client. o 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 12, Interclient Communication. Errors BadAlloc BadWindow See Also XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(). Xlib - Window Manager Hints XStoreName()