[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


A VendorShell function that activates a protocol


#include <Xm/Protocols.h>
void XmActivateProtocol
shellAtom propertyAtom


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.

Specifies the widget with which the protocol property is associated

Specifies the protocol property

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).

[ Previous | Next | Contents | Glossary | Home | Search ]