XGetWMName()XGetWMName()NameXGetWMName – read a window's XA_WM_NAME property.
Synopsis
Status XGetWMName(display, w, text_prop_return)
Display *display;
Window w;
XTextProperty *text_prop_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window.
text_prop_return
Returns the XTextProperty structure. This structure should be
freed when no longer needed.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
DescriptionXGetWMName() performs an XGetTextProperty() on the XA_WM_NAME property
of the specified window. XGetWMName() supersedes XFetchName().
XGetWMName() returns non-zero if it succeeds, and zero if the property
has not been set for the argument window.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Structures
typedef struct {
unsigned char *value; /* same as Property routines */
Atom encoding; /* prop type */
int format; /* prop data format: 8, 16, or 32 */
unsigned long nitems; /* number of data items in value */
} XTextProperty;
See AlsoXGetWMIconName(), XSetWMIconName(), XSetWMName(), XSetWMProperties().
Xlib - Window Manager Hints XGetWMName()