XmSetProtocolHooks(X3mot)
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 WM_PROTOCOLS.
- 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(X3mot).
References
VendorShell(X3mot),
XmInternAtom(X3mot)
and
XmSetWMProtocolHooks(X3mot).
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.