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 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(3X).

     RELATED INFORMATION
          VendorShell(3X), XmInternAtom(3X), and
          XmSetWMProtocolHooks(3X).