NAME    [Toc]    [Back]

       XmSetProtocolHooks  -  A  VendorShell function that allows
       pre and post actions to be executed when a  protocol  message
 is received from MWM

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       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.  Specifies the  widget
       with  which  the protocol property is associated Specifies
       the protocol property Specifies the protocol atom  (or  an
       int  cast  to Atom) Specifies the procedure to call before
       calling entries on the client callback-list Specifies  the
       client data to be passed to the prehook when it is invoked
       Specifies the procedure to call after calling  entries  on
       the  client  callback-list 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).

SEE ALSO    [Toc]    [Back]

       VendorShell(3X),     XmInternAtom(3X),    XmSetWMProtocolHooks(3X)



                                           XmSetProtocolHooks(3X)