名称

XSetCommand, XGetCommand − ウィンドウの WM_COMMAND 属性を設定、または読み出す。

形式

XSetCommand(display, w, argv, argc)
      Display ∗display;
      Window w;
      char ∗∗argv;
      int argc; Status XGetCommand(display, w, argv_return, argc_return)
      Display ∗display;
      Window w;
      char ∗∗∗argv_return;
      int ∗argc_return;

引数

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

argc_return引数の数を返します。

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

argv_returnアプリケーションの引数リストを返します。

displayX サーバへのコネクションを指定します。

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

解説

XSetCommand 関数は、アプリケーションを呼び出すために使用するコマンド、 および引数を設定します。 (通常 argv は、主プログラムの argv 配列です。) XSetCommand は、 BadAlloc および BadWindow エラーを生じることがあります。 XGetCommand 関数は指定されたウィンドウから WS_COMMAND 属性を読み出して 文字列リストを返します。 WS_COMMAND 属性があれば、 その属性は文字列型でフォマットが 8 で格納されています。 文字列リストを格納するのに十分なメモリが割り当てられるなら、 XGetCommand は、 argv_return と argc_return の値に格納して、ゼロ以外を返します。 格納できない場合は、ゼロを返します。 文字列リストに与えられたメモリを解放するには、 XFreeStringListを使います。

特性

WM−COMMAND コマンドと引数は、アプリケーションで使えるように ASCII null で区切られています。

診断

BadAlloc サーバが要求されたリソース、またはサーバメモリの割当てに失敗した。

BadWindow
Window 引数の値が、定義された Window を指さない。
 

関連事項

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

NEWS-OSRelease 4.1C