名称

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 関数は XSetTextProperty を呼んで、WM_NAME 属性を設定します。 XGetWMName 関数は XGetTextProperty を呼んで、WM_NAME 属性を得ます。 成功した場合は、ゼロ以外のステータスを、 それ以外の場合はゼロのステータスを返します。 XStoreName 関数は window_name に渡される名称を指定ウィンドウに割り当てます。 ウィンドウマネージャはタイトルバーのような目立つ場所にウィンドウ名を表示させ、 ユーザが簡単にウィンドウを識別出来るようにします。 アプリケーションでウィンドウアイコン名を設定した場合、 ウィンドウマネージャがアイコン名を使い、 ウィンドウ名をアイコン内に表示させます。 文字列がホストポータブル文字コード (Host Portable Character Encoding) にない場合は、 結果は、インプリメンテーションにより異なります。 XStoreName で発生するエラーには、 BadAlloc および BadWindow エラーがあります。 XFetchName 関数は指定ウィンドウの名称を返します。 成功すれば、ゼロ以外を返します。 さもなければ ウィンドウに対して名称が設定されず、 ゼロを返します。 WM_NAME 属性がこのウィンドウに対して設定されなかった場合、 XFetchName は window_name_return をナルに設定します。 サーバが返すデータが ラテンポータブル文字コード (Latin Portable Character Encoding) の場合は、返される文字列は、 ホストポータブル文字コード (Host Portable Character Encoding) になります。 それ以外の場合は、結果はインプリメンテーションにより異なります。 必要なくなったら、 クライアントは XFree を使って、ウィンドウ名（文字列）を解放しなければなりません。 XFetchName で発生するエラーには、 BadWindow エラーがあります。

属性

WM_NAME アプリケーション名称

診断

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

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

関連事項

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

NEWS-OSRelease 4.2.1R