XSetCommand(3X11)

名前
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
    アプリケーションの引き数のリストが返される。

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

w   ウィンドウを指定。

説明
関数 はアプリケーションの起動に使われたコマンドと引き数をセットする。 (通常は、argv はアプリケーションのメインプログラムの argv 配列である。) 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合、実行結果は実装依存である。

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

関数 は指定したウィンドウの WM_COMMAND プロパティを取得し、文字列のリストを 返す。 WM_COMMAND プロパティが存在するならば、これは STRING型、フォーマット 8 である。 文字列のリストを格納するのに十分なメモリがアロケートできれば、 は引き数 argv_return と argc_return をセットし、ゼロでないステータスを返 す。 そうでなければゼロのステータスを返す。 サーバが返すデータのエンコーディングが Latin ポータブル文字エンコーディ ングならば、関数が返す文字列のエンコーディングはホストポータブル文字エ ンコーディングである。 そうでない場合の結果は実装依存である。 文字列リストに対してアロケートされたメモリを解放するには を使用すること。

プロパティ

WM_COMMAND
    コマンドと引き数。NULL で終わる文字列で、アプリケーションの起動に使用さ れたもの。

返り値

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

引き数 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