XmDeactivateProtocol(library call)										XmDeactivateProtocol(library call)

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

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

RELATED

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

														XmDeactivateProtocol(library call)