XSetTextProperty() XSetTextProperty()
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
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window.
text_prop Specifies the XTextProperty structure to be used.
property Specifies 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().
Xlib - Window Manager Hints XSetTextProperty()