NAME

       XmActivateProtocol  —  A VendorShell function that activates a protocol "XmActivateProtocol" "VendorShell
       functions" "XmActivateProtocol" "protocols"

SYNOPSIS

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

DESCRIPTION

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

RELATED

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

                                                                                           XmActivateProtocol(3)