Museum

 XmDeactivateProtocol(Xm)       6 January 1993       XmDeactivateProtocol(Xm)


 Name

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

 Syntax


    #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

    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.sendmsg 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 proto-
    col is active and the shell is realized, the property contains the proto-
    col Atom. If the protocol is inactive, the Atom is not present in the
    property.

    XmDeactivateWMProtocol is a convenience interface. It calls XmDeactivate-
    Protocol 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(Xm).

 See also

    mwm(Xm), VendorShell(Xm), XmDeactivateWMProtocol(Xm) and
    XmInternAtom(Xm).