XStringListToTextProperty

Syntax

Status XStringListToTextProperty(list, count, text_prop_return)
      char **list;
      int count;
      XTextProperty *text_prop_return;

Arguments

list Specifies a list of null-terminated character strings.
count Specifies the number of strings.
text_prop_return Returns the XTextProperty structure.

Description

The XStringListToTextProperty() function sets the specified XTextProperty to be of type STRING (format 8) with a value representing the concatenation of the specified list of null-separated character strings. An extra null byte (which is not included in the nitems member) is stored at the end of the value field of text_prop_return. The strings are assumed (without verification) to be in the STRING encoding. If insufficient memory is available for the new value string, XStringListToTextProperty() does not set any fields in the XTextProperty structure and returns a zero status. Otherwise, it returns a nonzero status. To free the storage for the value field, use XFree().

See also

XAllocClassHint(), XAllocIconSize(), XAllocSizeHints(), XAllocWMHints(), XFree(), XFreeStringList(), XSetCommand(), XSetTransientForHint(), XSetTextProperty(), XSetWMClientMachine(), XSetWMColormapWindows(), XSetWMIconName(), XSetWMName(), XSetWMProperties(), XSetWMProtocols(), XTextPropertyToStringList(), "Converting String Lists".
Christophe Tronche, ch@tronche.com