XmActivateProtocol(3X)

     NAME
          XmActivateProtocol - A VendorShell function that activates a
          protocol

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

     VERSION
          This page documents Motif 2.1.

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