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、 構造体の、値のフィールド、エンコーディング・フィールド、フォーマットフィールド、nitemフィールドによって決定されます。その属性がすでに存在しない場合には、 XSetTextProperty は指定されたウィンドウに設定します。 XSetTextProperty で発生するエラーには、 BadAlloc、 BadAtom、 BadValue、 BadWindow があります。 XGetTextProperty 関数はウィンドウからの指定属性を読み、そのデータをリターン値の XTextProperty 構造体に格納します。この関数は、データを値フィールドにデータタイプをエンコーディングフィールドにデータフォーマットをフォーマットフィールドデータの項目数をnitemsフィールドに格納します。属性のエンコーディングの特別の解釈およびデータはテキストとして呼び出すアプリケーションに残されます。指定の属性がウィンドウ上に存在しない場合、 XGetTextProperty は値フィールドをヌル、エンコーディングフィールドをNone、フォーマットフィールドを0, nitemフィールドをゼロに設定します。以上のファイルを XTextProperty 構造体に設定出来るのであれば、 XGetTextProperty はゼロ以外のステータスを返します。そうでなければ、ゼロのステータスを返します。 XGetTextProperty で発生するエラーには、 BadAtom および BadWindow エラーがあります。

属性

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

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

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

WM_NAME アプリケーション名

診断

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

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

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

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

Museum

Related Articles

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

関数

シンタックス

引数

解説

属性

診断

関連事項