名称

XStringListToTextProperty、XTextPropertyToStringList、XFreeStringList、XTextProperty − 文字列リストおよびテキスト属性構造体を変換します

形式

Status XStringListToTextProperty(list, count, text_prop_return)
      char ∗∗list;
      int count;
      XTextProperty ∗text_prop_return; Status XTextPropertyToStringList(text_prop, list_return, count_return)
       XTextProperty ∗text_prop;
       char ∗∗∗list_return;
       int ∗count_return; void XFreeStringList(list)
      char ∗∗list;

引数

count文字列の数を指定します。

count_return文字列の数を返します。

list解放する文字列のリストを指定します。

listナルで終わる文字列リストを指定します。

list_returnナルで終わる文字列リストを返します。

text_prop使用する XTextProperty 構造体を指定します。

text_prop_return
XTextProperty 構造体を返します。

解説

XStringListToTextProperty 関数は指定した XTextProperty をナルで分けられる文字列の指定リストのつながりを表す値の タイプ STRING (フォーマット 8)に設定します。 エキストラナル（nitems メンバに含まれない） が text_prop_return のフィールドの最後に格納されます。 文字列は、(特に確かめずに) STRING のコードであるとみなされます。 新しい文字列値に対してメモリの領域が不足する場合、 XStringListToTextProperty は XTextProperty 構造体にいかなるフィールドも設定せず、 ゼロのステータスを返します。 そうでなければ、 ゼロ以外のステータスを返します。 そのフィールドの内容を解放するために、 XFree を使って下さい。 XTextPropertyToStringList 関数は指定した XTextProperty 構造体のナルで終わるエレメントを表す文字列のリストを返します。 text_prop のデータはタイプが STRING、 フォーマットは 8 でなければならない。 その属性の複合エレメント（例えば、分離テキストセレクションの文字列）は ナル（0 符号）で分離されます。 その属性の内容はナルで終了されません。 リストおよびエレメントのためのメモリの領域が不足する場合、 XTextPropertyToStringList は何も値を返さず、 ゼロのステータスを返します。 そうでなければ、 ゼロ以外のステータスを返します。 リストおよびその内容を解放するためには XFreeStringList を使って下さい。 XFreeStringList 関数は、 XmbTextPropertyToTextList および XTextPropertyToStringList で割り当てられたメモリ、および、 XCreateFontSet で割り当てられた足りない文字セットのリストを解放します。

構造体

XTextProperty 構造体は、以下の様になります。

typedef struct {
unsigned char ∗value;/∗ property data ∗/
Atom encoding;/∗ type of property ∗/
int format;/∗ 8, 16, or 32 ∗/
unsigned long nitems;/∗ number of items in value ∗/
} XTextProperty;

関連事項

XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R