XFetchName() XFetchName()
Name
XFetchName - get a window's name (XA_WM_NAME property).
Synopsis
Status XFetchName(display, w, window_name_return)
Display *display;
Window w;
char **window_name_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window whose name you want a pointer set to.
window_name_return
Returns a pointer to the window name, which will be a NULL-terminated string. If the XA_WM_NAME property has not been set for
this window, XFetchName() sets window_name_return to NULL. When finished with it, a client must free the name string using
XFree().
Returns
Zero on failure, non-zero on success.
Description
XFetchName() is superseded by XGetWMName() in Release 4. XFetchName() returns the current value of the XA_WM_NAME property for the speci-
fied window. XFetchName() returns non-zero if it succeeds, and zero if the property has not been set for the argument window.
If the data returned by the server is in the Latin Portable Character Encoding, then the returned string is in the Host Portable Character
Encoding. Otherwise, the result is implementation-dependent.
For more information, see Volume One, Chapter 12, Interclient Communication, and Chapter 16, Window Management.
Errors
BadWindow
See Also
XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGet-
ZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(),
XSetWMHints(), XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XFetchName()
