DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmAddProtocolCallback(Xm)


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 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.

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).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003