Museum

 XmSetProtocolHooks(Xm)         6 January 1993         XmSetProtocolHooks(Xm)


 Name

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

 Syntax


    #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 call-
    back lists, this allows the shell to control the flow while leaving the
    protocol manager structures opaque.

    XmSetWMProtocolHooks is a convenience interface.  It calls XmSetProto-
    colHooks with the property value set to the atom returned by interning
    WMPROTOCOLS.

    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

    preclosure
            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

    postclosure
            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(Xm).

 See also

    VendorShell(Xm), XmInternAtom(Xm) and XmSetWMProtocolHooks(Xm).