XSetWMName(3X11)

名前
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;

引き数

display
    X サーバへの接続を指定。

text_prop
    使用される 構造体を指定。

text_prop_return
    構造体を返す。

w   ウィンドウを指定。

window_name
    ウィンドウ名を指定。 これは NULL で終わる文字列でなければならない。

window_name_return
    ウィンドウ名を返す。 これは NULL で終わる文字列である。

説明
簡易関数 は、 を呼び出して WM_NAME プロパティを設定する。

簡易関数 は、 を呼び出して WM_NAME プロパティを取得する。 この関数は成功時にはゼロでないステータスを返し、そうでない場合にはゼロ のステータスを返す。

関数 は window_name に渡された名前を指定されたウィンドウに割り付ける。 ウィンドウマネージャはウィンドウ名をウィンドウの目立つ場所(例えばタイ トルバー)に表示し、ユーザにウィンドウの識別を容易にさせる。 アプリケーションからアイコン名が与えられた場合、ウィンドウのアイコンに はアイコン名を使うことが推奨されているが、ウィンドウによってはウィンド ウ名をアイコンに表示するものもある。 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合には、実行結果は実装依存である。

はエラー および を起こすことがある。

関数 は指定したウィンドウの名前を返す。 成功時にはこの関数はゼロでないステータスを返す。 そうでない場合、ウィンドウに名前がセットされたことがあれば、この関数は ゼロを返す。 このウィンドウに対して WM_NAME プロパティが1度もセットされたことがなけ れば、 は window_name_return に NULL をセットする。 サーバが返す文字列のエンコーディングが Latin ポータブル文字エンコーディ ングであれば、返される文字列のエンコーディングはホストポータブル文字エ ンコーディングである。 そうでない場合の結果は実装依存である。 ウィンドウ名の文字列を使い終った後には、クライアントは を使ってこれを解放しなければならない。

はエラー を起こすことがある。

プロパティ

WM_NAME
    アプリケーションの名前。

返り値

サーバが、要求されたリソースやサーバメモリのアロケートに失敗した。

引き数 Window の値が定義されている 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