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 remov-
       ing 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, proto-
       col  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  XmInter-
       nAtom(3).

							       XmDeactivateProtocol(library call)