XmActivateProtocol(3X) — DG/UX R4.11MU05



XmActivateProtocol(3X)        SDK X11 R4.11MU05       XmActivateProtocol(3X)


NAME
       XmActivateProtocol--A VendorShell function that activates a protocol

SYNOPSIS
       #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
       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 WMPROTOCOLS.


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


Licensed material--property of copyright holder(s)
Museum
