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