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

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

wSpecifies 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 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 10, Interclient Communication, and Chapter 14, Window Management. 

ERRORS

BadWindow

SEE ALSO

XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(), XSetZoomHints(), XStoreName(). 

Xlib Reference Manual