XmActivateProtocol(3X)

NAME
     XmActivateProtocol --A VendorShell function that activates a protocol

SYNOPSIS
     #include <Xm/Xm.h>
     #include <Xm/Protocols.h>

     void XmActivateProtocol (shell, property, protocol)
          Widget    shell;
          Atom      property;
          Atom      protocol;

     void XmActivateWMProtocol (shell, protocol)
          Widget    shell;
          Atom      protocol;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmActivateProtocol  activates  a protocol.  It updates the handlers and the
     property if the shell is realized.  It is sometimes useful to allow a  pro-
     tocol'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:  ac-
     tive 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 XmActivateProto-
     col with the property value set to the atom returned by interning WM_PROTO-
     COLS.


     shell  Specifies the widget with which the protocol property is associated.

     property
            Specifies the protocol property.

     protocol
            Specifies the protocol Atom (or an int type cast to Atom).


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

RELATED INFORMATION
     VendorShell(3X), XmActivateWMProtocol(3X) and XmInternAtom(3X).

                                                          XmActivateProtocol(3X)