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(
          Widget shell,
          Atom property,
          Atom protocol);

     VERSION
          This page documents Motif 2.1.

     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, and so on) 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_msgentries in the MWM system menu.  To
          support this capability, protocol is allowed to be in one of
          two states: active or inactive.  If protocol is active and
          shell is realized, property contains the protocol Atom.  If
          protocol is inactive, Atom is not present in the property.

          XmDeactivateWMProtocol is a convenience interface.  It calls
          XmDeactivateProtocolwith 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
          mwm(1), VendorShell(3), XmActivateProtocol(3),
          XmDeactivateWMProtocol(3), and XmInternAtom(3).