XmSetProtocolHooks - Man Page
A VendorShell function that allows preactions and postactions to be executed when a protocol message is received from MWM
Synopsis
#include <Xm/Xm.h> #include <Xm/Protocols.h> void XmSetProtocolHooks( Widget shell, Atom property, Atom protocol, XtCallbackProc prehook, XtPointer pre_closure, XtCallbackProc posthook, XtPointer post_closure);
Description
XmSetProtocolHooks 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.
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
- 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(3).
Related
VendorShell(3), XmInternAtom(3), and XmSetWMProtocolHooks(3).