関数

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;

引数

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

countリスト内にプロトコル数を指定します。

count_returnリスト内のプロトコルの数を返します。

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

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

解説

XSetWMProtocols 関数は指定ウィンドウのWM_PROTOCOLS属性をプロトコル引数で指定される atomsのリストで置き換えます。 その属性がなければ、 XSetWMProtocols は指定ウィンドウのWM_PROTOCOLS属性をプロトコル引数で指定されたatoms のリストに設定します。 また、 その属性はタイプがATOMで、 フォーマットが32で格納されます。 WM_PROTOCOLS atomを制限出来なければ、 XSetWMProtocols はゼロのステータスを返します。 そうでなければ、 ゼロ以外を返します。 XSetWMProtocols で発生するエラーには、 BadAlloc および BadWindow エラーがあります。 XGetWMProtocols 関数は指定ウィンドウのWM_PROTOCOLS属性に格納されたatomsのリストを返します。 これらのatomにはこのウィンドウのオーナが関連するプロトコルについて記述されています。 その属性が存在し、 タイプがATOMでフォーマットが32であり、 また atom WM_PROTOCOLSが制限出来れば、 XGetWMProtocols は引数protocols_returnをatomsのリストに設定、また引数count_returnを リスト内の要素数に設定、 そしてゼロ以外のステータスを返します。 そうでなければ引数を返さず、 ゼロを返します。 atomのリストを解放する為、 XFree を使います。 XGetWMProtocols で発生するエラーには BadWindow エラーがあります。

属性

WM_PROTOCOLS
クリイアントと関連するウィンドウマネージャ間の通信プロトコルを定義するatomのリスト

診断

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

BadWindow
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

NEWS-OSRelease 4.1C