XmActivateProtocol(3X)



     XmActivateProtocol(3X)    UNIX System V    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 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 WMPROTOCOLS.


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




     Page 1                                          (printed 4/30/98)



     XmActivateProtocol(3X)    UNIX System V    XmActivateProtocol(3X)



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




















































     Page 2                                          (printed 4/30/98)

Museum