XGetWMName() XGetWMName()
Name
XGetWMName - 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.
Description
XGetWMName() 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 Communication.
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 Also
XGetWMIconName(), XSetWMIconName(), XSetWMName(), XSetWMProperties().
Xlib - Window Manager Hints XGetWMName()
