'\" t
.\" AddProtA.sgm /main/9 1996/09/25 10:11:01 cdedoc $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmAddProtocolCallback" 3
.SH "NAME"
\fBXmAddProtocolCallback\fP \(em A VendorShell function that adds client callbacks for a protocol
"XmAddProtocolCallback"
"VendorShell functions" "XmAddProtocolCallback"
"protocols"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Protocols\&.h>
\fBvoid \fBXmAddProtocolCallback\fP\fR(
\fBWidget \fBshell\fR\fR,
\fBAtom \fBproperty\fR\fR,
\fBAtom \fBprotocol\fR\fR,
\fBXtCallbackProc \fBcallback\fR\fR,
\fBXtPointer \fBclosure\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmAddProtocolCallback\fP adds client callbacks for a protocol\&. It
checks if the protocol is registered, and if it is not,
calls \fBXmAddProtocols\fP\&. It then adds the callback to
the internal list\&. These callbacks are called when
the corresponding client message is received\&.
.PP
\fBXmAddWMProtocolCallback\fP is a convenience interface\&.
It calls \fBXmAddProtocolCallback\fP
with the property value set to the atom returned by
interning \fBWM_PROTOCOLS\fP\&.
.IP "\fIshell\fP" 10
Specifies the widget with which the protocol property is associated
.IP "\fIproperty\fP" 10
Specifies the protocol property
.IP "\fIprotocol\fP" 10
Specifies the protocol \fBAtom\fP
.IP "\fIcallback\fP" 10
Specifies the procedure to call when a protocol message is received
.IP "\fIclosure\fP" 10
Specifies the client data to be passed to the callback when it is invoked
.PP
For a complete definition of VendorShell and its associated resources, see
\fBVendorShell\fP(3)\&.
.SH "RELATED"
.PP
\fBVendorShell\fP(3),
\fBXmAddWMProtocolCallback\fP(3),
\fBXmInternAtom\fP(3), and
\fBXmRemoveProtocolCallback\fP(3)\&.
.\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:17