XmAddProtocolCallback(3X)

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

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

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

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


VERSION
     This page documents version 1.2 of the Motif library.

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 XmAddProto-
     colCallback 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 type cast to Atom).

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

     closureSpecifies  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(3X).

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

                                                       XmAddProtocolCallback(3X)