Man Linux: Main Page and Category List

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

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

                                              XmSetProtocolHooks(library call)