XmDeactivateProtocol(3X)

     NAME
          XmDeactivateProtocol - A VendorShell function that
          deactivates a protocol without removing it

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

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

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


     VERSION
          This page documents version 1.2 of the Motif library.

     DESCRIPTION
          XmDeactivateProtocol deactivates a protocol without removing
          it.  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, etc.) to persist, even
          though the client may choose to temporarily resign from the
          interaction.  The main use of this capability is to
          gray/ungray f.send_msg entries in the Mwm system menu.  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.

          XmDeactivateWMProtocol is a convenience interface.  It calls
          XmDeactivateProtocol 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 (or an int type cast to
                 Atom)


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

     RELATED INFORMATION
          mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), and
          XmInternAtom(3X).