XmSetProtocolHooks(3X) OSF XmSetProtocolHooks(3X)
NAME
XmSetProtocolHooks-A VendorShell function that allows pre
and post actions to be executed when a protocol message is
received from MWM
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/Protocols.h>
void XmSetProtocolHooks (shell, property, protocol, prehook, pre_closure,
posthook, post_closure)
Widget shell;
Atom property;
Atom protocol;
XtCallbackProc prehook;
XtPointer pre_closure;
XtCallbackProc posthook;
XtPointer post_closure;
void XmSetWMProtocolHooks (shell, protocol, prehook, pre_closure,
posthook, post_closure)
Widget shell;
Atom protocol;
XtCallbackProc prehook;
XtPointer pre_closure;
XtCallbackProc posthook;
XtPointer post_closure;
DESCRIPTION
XmSetProtocolHooks is used by shells that want to have pre
and post actions 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.
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
1 (printed 6/8/92)
XmSetProtocolHooks(3X) OSF XmSetProtocolHooks(3X)
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(3X).
RELATED INFORMATION
VendorShell(3X), XmInternAtom(3X), and
XmSetWMProtocolHooks(3X).
2 (printed 6/8/92)