XSetTextProperty

Syntax

void XSetTextProperty(display, w, text_prop, property)
      Display *display;
      Window w;
      XTextProperty *text_prop;
      Atom property;

Arguments

display Specifies the connection to the X server.
w Specifies the window.
text_prop Specifies the XTextProperty structure to be used.
property Specifies the property name.

Description

The XSetTextProperty() function replaces the existing 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. If the property does not already exist, XSetTextProperty() sets it for the specified window.

XSetTextProperty() can generate BadAlloc, BadAtom, BadValue, and BadWindow errors.

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadAtom A value for an Atom argument does not name a defined Atom.
BadWindow A value for a Window argument does not name a defined Window.

See also

XAllocClassHint(), XAllocIconSize(), XAllocSizeHints(), XAllocWMHints(), XGetTextProperty(), XSetCommand(), XSetTransientForHint(), XSetWMClientMachine(), XSetWMColormapWindows(), XSetWMIconName(), XSetWMName(), XSetWMProperties(), XSetWMProtocols(), XStringListToTextProperty(), "Setting and Reading Text Properties".
Christophe Tronche, ch@tronche.com