名称

XSetWMProperties、XmbSetWMProperties − 標準ウィンドウプロパティを設定する

形式

void XSetWMProperties(display, w, window_name, icon_name, argv, argc, normal_hints, wm_hints, class_hints)
      Display ∗display;
      Window w;
      XTextProperty ∗window_name;
      XTextProperty ∗icon_name;
      char ∗∗argv;
      int argc;
      XSizeHints ∗normal_hints;
      XWMHints ∗wm_hints;
      XClassHint ∗class_hints; void XmbSetWMProperties(display, w, window_name, icon_name, argv, argc,
                      normal_hints, wm_hints, class_hints)
      Display ∗display;
      Window w;
      char ∗window_name;
      char ∗icon_name;
      char ∗argv[];
      int argc;
      XSizeHints ∗normal_hints;
      XWMHints ∗wm_hints;
      XClassHint ∗class_hints;

引数

argc引数の数を指定します。

argvアプリケーションの引数リストを指定します。

class_hintsXClassHint 構造体を指定します。

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

icon_nameナルで終わるアイコン名を指定します。

normal_hints通常時のウィンドウのサイズヒントを指定します。

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

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

wm_hints使用される XWMHints 構造体を指定します。

解説

XSetWMProperties 用関数には、 他のクライアント（特に、 ウィンドウおよびセションマネージャ）との通信時に使う際に有効な ウィンドウ属性を設定するために、 一つのプログラミングインターフェースがあります。 引数 window_name がナル以外であれば、 XSetWMProperties は XSetWMName をコールし、 WM_NAME 属性(14.1.4 を参照)が設定されます。 引数 icon_name がナル以外であれば、 XSetWMProperties が XSetWMIconName をコールし、 WM_ICON_NAME 属性（14.1.5 を参照)が設定されます。 引数 argv がナル以外であれば、 XSetWMProperties は XSetCommand をコールし、 WM_COMMAND 属性が設定されます(14.2.1 を参照)。 ゼロの argc がデータ長ゼロのコマンドを示すようになっています。 また、 このマシンのホスト名が XSetWMClientMachine (14.2.2 を参照)を使って格納されています。 引数 normal_hints がナル以外であれば、 XSetWMProperties は XSetWMNormalHints を呼び、 WM_NORMAL_HINTS 属性(14.1.7 を参照)が設定されます。 引数 wm_hints がナル以外であれば、 XSetWMProperties は XSetWMHints をコールし、 WM_HINTS 属性(14.1.6 を参照）が設定されます。 引数 class_hints がナル以外であれば、 XSetWMProperties は XSetClassHint を呼び、WM_CLASS 属性(14.1.8 を参照）が設定されます。 XClassHint 構造体の res_name メンバがナルポインタに設定され、 RESOURCE_NAME 環境変数が設定されれば、 環境変数の値は res_name の代りになります。 res_name メンバがナルになり、 環境変数が設定されず、 argv および argv[0] が設定されれば、 ディレクトリプレフィックスがストリップされ、 argv[0] の値が res_name の代りになります。 XmbSetWMProperties 用関数には、 他のクライアント (特に、ウィンドウおよびセションマネージャ）との 通信時に使う際に有効なウィンドウ属性を設定するために、 一つのプログラミングインターフェースがあります。 引数 window_name がナル以外であれば、 XmbSetWMProperties は WM_NAME 属性を設定します。 引数 icon_name がナル以外であれば、 XmbSetWMProperties は WM_ICON_NAME 属性を設定します。 引数 window_name と icon_name は、 現在の locale のコードのナルで終了する文字列です。 引数が STRING コードに変換できる場合は、 属性は、“STRING” 型で作成されます。 できない場合は、 引数は、コンパウンドテキストに変換され、 属性は、“COMPOUND_TEXT” 型で作成されます。 引数 normal_hints がナル以外であれば、 XmbSetWMProperties は XSetWMNormalHints を呼んで、WM_NORMAL_HINTS 属性 (14.1.1 節を参照) を設定します。 引数 wm_hints がナル以外であれば、 XmbSetWMProperties は XSetWMHints を呼んで、WM_HINTS 属性 (14.1.6 節を参照) を設定します。 引数 argv がナル以外であれば、 XmbSetWMProperties は argv と argc から、WM_COMMAND 属性を設定します。 ゼロの argc がデータ長ゼロのコマンドを示すようになっています。 また、このマシンのホスト名が XSetWMClientMachine (14.2.2 を参照)を使って格納されています。 引数 class_hints がナル以外であれば、 XmbSetWMProperties は WM_CLASS 属性を設定します。 XClassHint 構造体の res_name メンバがナルポインタに設定され、 RESOURCE_NAME 環境変数が設定された場合は、 環境変数の値が res_name に代入されます。 res_name メンバがナルで、 環境変数が設定されず、 argv および argv[0] が設定されている場合は、 ディレクトリプレフィックスがストリップされ、 argv[0] の値が res_name に代入されます。 指定された  class_hints.res_name および argv、 RESOURCE_NAME 環境変数、およびマシンのホスト名は、 LC_CTYPE カタゴリに指定されている locale のコードであると みなします。 (POSIX 準拠のシステムでは、LC_CTYPE の他に、 LANG 環境変数があります。) 対応する  WM_CLASS、WM_COMMAND、および WM_CLIENT_MACHINE プロパティは ローカルなホストの locale に合わせて、型が決められます。 プロパティに格納する前に、コード変換は行われません。 ある locale でプロパティのテキストを処理する必要のあるクライアントは、 XmbSetWMProperties が、 クライアントの locale の名前を WM_LOCALE_NAME プロパティに設定します。 名前は、ホストポータブル文字コード (Host Portable Character Encoding) にあるとみなされ、プロパティに格納する前に、 STRING へ変換されます。 XSetWMProperties および XmbSetWMProperties は、 BadAlloc および BadWindow エラーを生じることがあります。

属性

WM_CLASS ウィンドウマネージャおよびセションマネージャがリ ソースデータベースからアプリケーションリソースを得るように アプリケーションプログラムで設定されます。

WM_CLIENT_MACHINE
クライアントが実行中のマシン名（文字列)。

WM_COMMAND
アプリケーションを呼び出す際の (ナルによって区切られた) コマンド および引数。

WM_HINTS ウィンドウマネージャが使用するために、 クライアントが追加で設定したヒント。 この属性の C 言語のタイプは XWMHints です。

WM_ICON_NAME
アイコンで使われる名称。

WM_NAME アプリケーション名。

WM_NORMAL_HINTS
通常時のウィンドウに対するサイズヒント。 この属性の C 言語のタイプは XSizeHints

診断

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

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

関連事項

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

NEWS-OSRelease 4.2.1R