XmDeactivateProtocol






XmDeactivateProtocol — A VendorShell function that
deactivates a protocol without removing it



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



     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_msg entries 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 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

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



     mwm(1), VendorShell(3), XmActivateProtocol(3),
XmDeactivateWMProtocol(3), and XmInternAtom(3).