NAME

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

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, 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(3)