'\" t
.\" SetProto.sgm /main/7 1996/08/30 16:06:00 rws $
.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 "XmSetProtocolHooks" 3
.SH "NAME"
\fBXmSetProtocolHooks\fP \(em A VendorShell function that allows preactions and postactions to be executed when a protocol message is received from MWM
"XmSetProtocolHooks"
"VendorShell functions" "XmSetProtocolHooks"
"protocols"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Xm\&.h>
#include <Xm/Protocols\&.h>
\fBvoid \fBXmSetProtocolHooks\fP\fR(
\fBWidget \fBshell\fR\fR,
\fBAtom \fBproperty\fR\fR,
\fBAtom \fBprotocol\fR\fR,
\fBXtCallbackProc \fBprehook\fR\fR,
\fBXtPointer \fBpre_closure\fR\fR,
\fBXtCallbackProc \fBposthook\fR\fR,
\fBXtPointer \fBpost_closure\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmSetProtocolHooks\fP is used by shells that want to have preactions
and postactions
executed when a protocol message is received from MWM\&.
Since there is no guaranteed ordering in execution of event handlers or
callback lists, this allows the shell to control the flow while leaving the
protocol manager structures opaque\&.
.PP
\fBXmSetWMProtocolHooks\fP is a convenience interface\&.
It calls \fBXmSetProtocolHooks\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 atom
.IP "\fIprehook\fP" 10
Specifies the procedure to call before calling entries on the client callback
list
.IP "\fIpre_closure\fP" 10
Specifies the client data to be passed to the prehook when it is invoked
.IP "\fIposthook\fP" 10
Specifies the procedure to call after calling entries on the client callback
list
.IP "\fIpost_closure\fP" 10
Specifies the client data to be passed to the posthook 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),
\fBXmInternAtom\fP(3), and \fBXmSetWMProtocolHooks\fP(3)\&.
.\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:30