XSetTextProperty(3X11) — NEWS-OS Programmer’s Manual

名称

XSetTextProperty、XGetTextProperty − テキストの属性を設定と読み出し

形式

void XSetTextProperty(display, w, text_prop, property)
      Display ∗display;
      Window w;
      XTextProperty ∗text_prop;
      Atom property; Status XGetTextProperty(display, w, text_prop_return, property)
       Display ∗display;
       Window w;
       XTextProperty ∗text_prop_return;
       Atom property;

引数

displayX サーバへの接続を指定します。

property属性名を指定します。

text_propXTextProperty 構造体を指定します。

text_prop_return
XTextProperty 構造体を返します。

解説

XSetTextProperty 関数はデータ、タイプ、フォーマット、項目数を持った指定したウィンドウにおいて、指定された属性が存在するときそれを変更します。項目数は、それぞれ XTextProperty 構造体の、value フィールド、エンコーディングフィールド、フォーマットフィールド、nitems フィールドによって決定されます。その属性がすでに存在しない場合には、 XSetTextProperty は指定されたウィンドウに設定します。 XSetTextProperty で発生するエラーには、 BadAlloc、 BadAtom、 BadValue、 BadWindow があります。 XGetTextProperty 関数はウィンドウからの指定属性を読み、そのデータをリターン値の XTextProperty 構造体に格納します。この関数は、データを value フィールドにデータタイプをエンコーディングフィールドにデータフォーマットをフォーマットフィールドデータの項目数を nitems フィールドに格納します。 text_prop_return の value フィールドの最後にさらにもう 1 バイト (nitems メンバには含まれていません) ナルが格納されます。属性のエンコーディングの特別の解釈およびデータはテキストとして呼び出すアプリケーションに残されます。指定の属性がウィンドウ上に存在しない場合、 XGetTextProperty は value フィールドをナルエンコーディングフィールドを None、フォーマットフィールドをゼロ、 nitems フィールドをゼロに設定します。データを XTextProperty 構造体から読みだしたり、格納できる場合は、 XGetTextProperty はゼロ以外のステータスを返します。それ以外の場合は、ゼロのステータスを返します。 XGetTextProperty で発生するエラーには、 BadAtom および BadWindow エラーがあります。

属性

WM_CLIENT_MACHINE
アプリケーションが実行中のマシンの名称（文字列）

WM_COMMAND
アプリケーションを呼び出す際のコマンドおよび引数で、ナルによって分けられます。

WM_ICON_NAME
アイコンとして使われる名称

WM_NAME アプリケーション名

診断

BadAlloc サーバはリクエストされたリソースまたはサーバメモリの割り当てに失敗した。

BadAtom Atom 引数に対する値が定義された Atom に一致しない。

BadValue いくつかの数値がリクエストに認められた値の範囲を超えています。指定した範囲が引数に対して指定したのであれば、引数のタイプで定義された全ての範囲が認められます。二者択一で定義された引数では、このエラーが発生する可能性があります。

BadWindow
Window 引数に対しての値が定義されたウィンドウに一致しません。

Museum

Related Articles

XSetTextProperty(3X11) — NEWS-OS Programmer’s Manual

名称

形式

引数

解説

属性

診断

関連事項