XFetchName()XFetchName()NameXFetchName – 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.
DescriptionXFetchName() is superseded by XGetWMName() in Release 4. XFetchName()
returns the current value of the XA_WM_NAME property for the specified
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 Communi‐
cation, and Chapter 16, Window Management.
Errors
BadWindow
See AlsoXGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(),
XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGet‐
ZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIcon‐
Sizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(),
XSetWMHints(), XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XFetchName()