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

関数

XSetWMName、XGetWMName、XStoreName、XFetchName − ウィンドウのWM_NAME属性を設定または読む

シンタックス

void XSetWMName(display, w, text_prop)
      Display ∗display;
      Window w;
      XTextProperty ∗text_prop; Status XGetWMName(display, w, text_prop_return)
      Display ∗display;
      Window w;
      XTextProperty ∗text_prop_return; XStoreName(display, w, window_name)
      Display ∗display;
      Window w;
      char ∗window_name; Status XFetchName(display, w, window_name_return)
      Display ∗display;
      Window w;
      char ∗∗window_name_return;

引数

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

text_propXTextProperty 構造体を指定します。

text_prop_return
XTextProperty 構造体を返します。

wウィンドウを指定します。

window_name
ナルで終わるウィンドウ名を指定します。

window_name_return
ナルで終わるウィンドウ名を返します。

解説

XSetWMName 関数はWM_NAME属性（9.1.3を参照）の XSetTextProperty を行います。 XGetWMName 関数はWM_NAME属性（9.1.3を参照）の XGetTextProperty を行います。 XStoreName 関数はwindow_nameに渡される名称を指定ウィンドウに割り当てます。ウィンドウマネージャはタイトルバーのような目立つ場所にウィンドウ名を表示させ、ユーザが簡単にウィンドウを識別出来るようにします。アプリケーションでウィンドウアイコン名を設定した場合、ウィンドウマネージャがアイコン名を使い、ウィンドウ名をアイコン内に表示させます。 XStoreName で発生するエラーには、 BadAlloc および BadWindow エラーがあります。 The XFetchName 関数は指定ウィンドウの名称を返します。成功すれば、ゼロ以外を返します。さもなければウィンドウに対して名称が設定されず、ゼロを返します。 WM_NAME属性がこのウィンドウに対して設定されなかった場合、 XFetchName はwindow_name_returnをナルに設定します。ナルで終わっていれば、クライアントは XFree を使って、ウィンドウ名（文字列）を解放しなければなりません。 XFetchName で発生するエラーには、 BadWindow エラーがあります。

属性

WM_NAME アプリケーション名称

診断

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

BadWindow
Window引数に対する値が定義されたウィンドウに一致しない。

Museum

Related Articles

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

関数

シンタックス

引数

解説

属性

診断

関連事項