XSetWMProtocols(3X11)

名前
XSetWMProtocols, XGetWMProtocols - ウィンドウの WM_PROTOCOLS プロパティの設定と取得

書式
Status XSetWMProtocols(display, w, protocols, count)
      Display *display;
      Window w;
      Atom *protocols;
      int count;

Status XGetWMProtocols(display, w, protocols_return, count_return)
      Display *display;
      Window w;
      Atom **protocols_return;
      int *count_return;

引き数

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

count
    リスト中のプロトコル の数を指定。

count_return
    リスト中のプロトコルの数を返す。

protocols
    プロトコルのリストを指定。

protocols_return
    プロトコルのリストを返す。

説明
関数 は、指定したウィンドウの WM_PROTOCOLS プロパティを、引き数 protocols で 指定したアトムのリストで置き換える。 プロパティが以前に指定されていなければ、 は指定されたウィンドウの WM_PROTOCOLS プロパティに引き数 protocols で指 定されたアトムのリストをセットする。 プロパティは ATOM 型、フォーマット 32 で保持される。 WM_PROTOCOLS アトムを確保することができなければ、 はゼロのステータスを返す。 そうでなければ、この関数はゼロでないステータスを返す。

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

関数 は指定したウィンドウの WM_PROTOCOLS プロパティに保持されているアトムの リストを返す。 これらのアトムは、このウィンドウの所有者が所属しようとしているウィンド ウマネージャのプロトコルを記述する。 もしプロパティが存在し、ATOM 型、フォーマット32であり、アトム WM_PROTOCOLS が確保可能であれば、 は引き数 protocols_return にアトムのリストをセットし、引き数 count_return にリストの要素数をセットして、ゼロでないステータスを返す。 そうでない場合は、いずれの引き数もセットされず、ゼロのステータスが返され る。 アトムのリストを解放するには、 を使用すること。

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

プロパティ

WM_PROTOCOLS
    クライアントと、クライアントが所属しようとしているウィンドウマネージャ 間の通信プロトコルを指定するアトムのリスト。

返り値

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

引き数 Window の値が、定義されている Window を指していない。

関連項目
XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XStringListToTextProperty(3X11)
Xlib - C Language X Interface