Index for Section 3X

Alphabetical listing for X

Bottom of page

XmSetProtocolHooks(3X)
OSF/Motif
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).

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

Index for Section 3X

Alphabetical listing for X

Top of page