RedHat 9 (Linux i386) - man page for xmdeactivateprotocol (redhat section 3)

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 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, pro-
       tocol 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)