XSetWMProtocols

Syntax

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

Arguments

display Specifies the connection to the X server.
X サーバへの接続を指定する。
w Specifies the window.
ウィンドウを指定する。
protocols Specifies the list of protocols.
プロトコルのリストを指定する。
count Specifies the number of protocols in the list.
リスト中のプロトコルの数を指定する。

Description

The XSetWMProtocols() function replaces the WM_PROTOCOLS property on the specified window with the list of atoms specified by the protocols argument. If the property does not already exist, XSetWMProtocols() sets the WM_PROTOCOLS property on the specified window to the list of atoms specified by the protocols argument. The property is stored with a type of ATOM and a format of 32. If it cannot intern the WM_PROTOCOLS atom, XSetWMProtocols() returns a zero status. Otherwise, it returns a nonzero status.
関数 XSetWMProtocolsは、指定したウィンドウの WM_PROTOCOLS プロパティを、引き数 protocols で 指定したアトムのリストで置き換える。 このプロパティが以前に指定されていなければ、 XSetWMProtocolsは引き数 protocols で指定されたアトムのリストを指定されたウィンドウの WM_PROTOCOLS プロパティに設定する。 プロパティは ATOM 型、フォーマット 32 で保持される。 WM_PROTOCOLS アトムを確保できなければ、 XSetWMProtocolsはステータスとして 0 を返す。 そうでなければ、この関数は 0 でないステータスを返す。

XSetWMProtocols() can generate BadAlloc and BadWindow errors.
XSetWMProtocolsはエラー BadAlloc ,BadWindowを起こすことがある。

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadWindow A value for a Window argument does not name a defined Window.

See also

XAllocClassHint(), XAllocIconSize(), XAllocSizeHints(), XAllocWMHints(), XGetWMProtocols(), XSetCommand(), XSetTextProperty(), XSetTransientForHint(), XSetWMClientMachine(), XSetWMColormapWindows(), XSetWMIconName(), XSetWMName(), XSetWMProperties(), XStringListToTextProperty(), "Setting and Reading the WM_TRANSIENT_FOR Property".
Christophe Tronche, ch.tronche@computer.org