XmActivateProtocol

XmActivateProtocol(library call)              XmActivateProtocol(library call)



NAME
       XmActivateProtocol — A VendorShell function that activates a protocol

SYNOPSIS
       #include <Xm/Protocols.h>
       void XmActivateProtocol(
       Widget shell,
       Atom property,
       Atom protocol);

DESCRIPTION
       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.

       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
       VendorShell(3), XmActivateWMProtocol(3), XmRemoveProtocols(3) and
       XmInternAtom(3).



                                              XmActivateProtocol(library call)