XmSetProtocolHooks(Xm) UNIX System V
NAME
XmSetProtocolHooks - a VendorShell function that allows pre
and post actions to be executed when a protocol message is
received from the window manager.
SYNOPSIS
#include <Xm/Xm.h>
#include <X11/Protocols.h>
void XmSetProtocolHooks (shell, property, protocol, prehook,
pre_closure, posthook, post_closure)
Widget shell;
Atom property;
Atom protocol;
XtCallbackProcprehook;
caddrt pre_closure;
XtCallbackProcposthook;
caddrt post_closure;
void XmSetWMProtocolHooks (shell, protocol, prehook,
pre_closure, posthook, post_closure)
Widget shell;
Atom protocol;
XtCallbackProcprehook;
caddrt pre_closure;
XtCallbackProcposthook;
caddrt post_closure;
DESCRIPTION
XmSetProtocolHooks is used by shells that want to have pre
and post actions executed when a protocol message is
received from the window manager. 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.
XmSetWMProtocolHooks is a convenience interface. It calls
XmSetProtocolHooks with the property value set to the atom
returned by interning WMPROTOCOLS.
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).
prehook Specifies the procedure to call before calling
entries on the client callback list.
pre_closure
Specifies the client data to be passed to the
prehook when it is invoked.
posthook Specifies the procedure to call after calling
entries on the client callback list.
post_closure
Specifies the client data to be passed to the
posthook when it is invoked.
For a complete definition of VendorShell and its associated
resources, see VendorShell(Xm).
RELATED INFORMATION
VendorShell(Xm), XmInternAtom(Xm), and
XmSetWMProtocolHooks(Xm).
(printed 2/14/90) XmSetProtocolHooks(Xm)