XmDeactivateProtocol(3X)

NAME
     XmDeactivateProtocol  -- A VendorShell function that deactivates a protocol
     without removing it

SYNOPSIS
     #include <Xm/Xm.h>
     #include <Xm/Protocols.h>

     void XmDeactivateProtocol (shell, property, protocol)
          Widget    shell;
          Atom      property;
          Atom      protocol;

     void XmDeactivateWMProtocol (shell, protocol)
          Widget    shell;
          Atom      protocol;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmDeactivateProtocol deactivates a protocol without removing  it.   It  up-
     dates the handlers and the property, if the shell is realized.  It is some-
     times useful to allow a protocol's state information (callback lists, etc.)
     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.  This is supported by allowing a
     protocol  to be in one of two states:  active or inactive.  If the protocol
     is active and the shell is realized, the  property  contains  the  protocol
     Atom.   If  the  protocol is inactive, the Atom is not present in the prop-
     erty.

     XmDeactivateWMProtocol is a  convenience  interface.   It  calls  XmDeacti-
     vateProtocol  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 (or an int type cast to Atom)


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

RELATED INFORMATION
     mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), and XmInternAtom(3X).

                                                        XmDeactivateProtocol(3X)