NAME    [Toc]    [Back]

       XmActivateProtocol - A VendorShell function that activates
       a protocol

SYNOPSIS    [Toc]    [Back]

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

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

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

DESCRIPTION    [Toc]    [Back]

       XmActivateProtocol activates a protocol.  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.
   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.

       XmActivateWMProtocol is a convenience interface.  It calls
       XmActivateProtocol 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]

       VendorShell(3X),     XmActivateWMProtocol(3X),    XmInternAtom(3X)



                                           XmActivateProtocol(3X)