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

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

wSpecifies the window. 

text_prop_return
Returns the XTextProperty structure. 

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 10, 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 Reference Manual