NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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, 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 property.

       XmDeactivateWMProtocol  is  a  convenience  interface.  It
       calls XmDeactivateProtocol with the property value set  to
       the  atom  returned  by interning WM_PROTOCOLS.  Specifies
       the widget with which the protocol property is  associated
       Specifies  the  protocol  property  Specifies the protocol
       atom (or an int type cast to Atom)

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

SEE ALSO    [Toc]    [Back]

       mwm(1X),    VendorShell(3X),   XmDeactivateWMProtocol(3X),
       XmInternAtom(3X)



                                         XmDeactivateProtocol(3X)