XmSetProtocolHooks(3X)

NAME
     XmSetProtocolHooks  -- A  VendorShell function that allows pre and post ac-
     tions 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;


VERSION
     This page documents version 1.2 of the Motif library.

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 XmSetProtocol-
     Hooks with the property value set to the atom returned by interning WM_PRO-
     TOCOLS.


     shell     Specifies the widget with which the protocol property is  associ-
               ated

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

                                                          XmSetProtocolHooks(3X)