名称

XmActivateProtocol — プロトコルをアクティブにする VendorShell 関数

形式

#include <Xm/Xm.h>
#include <X11/Protocols.h> void XmActivateProtocol (shell, property, protocol)
Widgetshell;
Atomproperty;
Atomprotocol; void XmActivateWMProtocol (shell, protocol)
Widgetshell;
Atomprotocol;

解説

XmActivateProtocol はプロトコルをアクティブにします。 shell が実現されると、ハンドラと property を更新します。 クライアントが一時的に対話から抜けても、プロトコルの状態に関する情報 (コールバックリストなど) を保持するので便利です。 これは、protocol が 2 つの状態 、アクティブとインアクティブのいずれかであることを許していることによります。 protocol がアクティブで shell が実現されていれば、property には protocol Atom が含まれています。 protocol がインアクティブなら、property の中には Atom は存在しません。

XmActivateWMProtocol は簡易インターフェースです。 これは、プロパティの値を WM_PROTOCOLS をインターン (intern) して返ってきたアトムに設定して、XmActivateProtocol を呼び出します。

shellプロトコルのプロパティに関係する widget を指定します。

propertyプロトコルのプロパティを指定します。

protocolプロトコル Atom (あるいは Atom への整数のキャスト) を指定します。

VendorShell の完全な定義と、関連するリソースに関する詳細は VendorShell (3X) を参照してください。

関連事項

VendorShell(3XM), XmActivateWMProtocol(3XM), XmInternAtom(3XM)

NEWS-OSRelease 4.1C