XmSetProtocolHooks(3X)

     NAME
          XmSetProtocolHooks - 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);

     VERSION
          This page documents Motif 2.1.

     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
          XmSetProtocolHookswith 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).