XmSetProtocolHooks(3X) SDK X11 R4.11MU05 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, preclosure,
posthook, postclosure)
Widget shell;
Atom property;
Atom protocol;
XtCallbackProc prehook;
XtPointer preclosure;
XtCallbackProc posthook;
XtPointer postclosure;
void XmSetWMProtocolHooks (shell, protocol, prehook, preclosure,
posthook, postclosure)
Widget shell;
Atom protocol;
XtCallbackProc prehook;
XtPointer preclosure;
XtCallbackProc posthook;
XtPointer postclosure;
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
preclosure
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
postclosure
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).
Licensed material--property of copyright holder(s)