XmActivateProtocol - Man Page

#include <Xm/Protocols​.h>
void XmActivateProtocol(
Widget shell,
Atom property,
Atom protocol);

XmActivateProtocol activates a protocol​. It updates the handlers and the property if the shell is realized​. It is sometimes useful to allow a protocol​'s state information (callback lists, and so on) to persist, even though the client may choose to temporarily resign from the interaction​. This is supported by allowing a protocol to be in one of two states: active or inactive​. If the protocol is active and the shell is realized, the property contains the protocol Atom​. If the protocol is inactive, the Atom is not present in the property​.

XmActivateWMProtocol is a convenience interface​. It calls XmActivateProtocol with the property value set to the atom returned by interning WM_PROTOCOLS​.

shell

Specifies the widget with which the protocol property is associated

property

Specifies the protocol property

protocol

Specifies the protocol Atom

For a complete definition of VendorShell and its associated resources, see VendorShell(3)​.

VendorShell(3), XmActivateWMProtocol(3), XmRemoveProtocols(3) and XmInternAtom(3)​.

VendorShell(3), XmActivateWMProtocol(3), XmDeactivateProtocol(3).