NAME

XSetTextProperty − set one of a window’s text properties. 

Synopsis

void XSetTextProperty(display, w, text_prop, property)

   Display *display;
   Window w;
   XTextProperty *text_prop;
   Atom property;

Arguments

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

wSpecifies the window. 

text_propSpecifies the XTextProperty structure to be used. 

propertySpecifies the property name. 

Availability

Release 4 and later. 

Description

XSetTextProperty() sets the specified property for the named window with the data, type, format, and number of items determined by the value field, the encoding field, the format field, and the nitems field, respectively, of the specified XTextProperty structure. 

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;

Errors

BadAlloc
BadAtom
BadValue
BadWindow

See Also

XFreeStringList(), XGetTextProperty(), XStringListToTextProperty(), XTextPropertytoStringList. 

Copyright O’Reilly & Assoc.  —