XmSetProtocolHooks

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