Museum

 XmAddProtocolCallback(Xm)      6 January 1993      XmAddProtocolCallback(Xm)


 Name

    XmAddProtocolCallback - a VendorShell function that adds client callbacks
    for a protocol

 Syntax


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

    void XmAddProtocolCallback (shell, property, protocol, callback, closure)
    Widget shell;
    Atom property;
    Atom protocol;
    XtCallbackProc callback;
    XtPointer closure;

    void XmAddWMProtocolCallback (shell, protocol, callback, closure)
    Widget shell;
    Atom protocol;
    XtCallbackProc callback;
    XtPointer closure;


 Description

    XmAddProtocolCallback adds client callbacks for a protocol.  It checks if
    the protocol is registered, and if it is not, calls XmAddProtocols.  It
    then adds the callback to the internal list.  These callbacks are called
    when the corresponding client message is received.

    XmAddWMProtocolCallback is a convenience interface.  It calls
    XmAddProtocolCallback with the property value set to the atom returned by
    interning WMPROTOCOLS.

    shell     Specifies the widget with which the protocol property is asso-
              ciated.

    property  Specifies the protocol property.

    protocol  Specifies the protocol Atom (or an int type cast to Atom).

    callback  Specifies the procedure to call when a protocol message is
              received.

    closure   Specifies the client data to be passed to the callback when it
              is invoked.

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

 See also

    VendorShell(Xm), XmAddProtocols(Xm), XmAddWMProtocolCallback(Xm) and
    XmInternAtom(Xm).