XmAddProtocolCallback(3Xm)

NAME
XmAddProtocolCallback — a VendorShell function that adds client callbacks for a protocol.

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

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

void XmAddWMProtocolCallback (shell, protocol, callback, closure)
    Widget    shell;
    Atom    protocol;
    XtCallbackProc    callback;
    caddr_t    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 will be 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 WM_PROTOCOLS.

shell
    Specifies the widget with which the protocol property is associated.

property
    Specifies the protocol property.

protocol
    Specifies the protocol Atom (or an int 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(3Xm).

RELATED INFORMATION
VendorShell(3Xm), XmAddProtocols(3Xm), XmAddWMProtocolCallback(3Xm), and XmInternAtom(3Xm).