hpux man page for xtinstallallaccelerators

XtInstallAllAccelerators()												XtInstallAllAccelerators()

Name
  XtInstallAllAccelerators - install all accelerators from a widget and its descendants onto a destination widget.

Synopsis
  void XtInstallAllAccelerators(destination, source)
	 Widget destination;
	 Widget source;

Inputs
  destination
	    Specifies the widget in which events specified in the accelerator tables will be detected.	Must be of class Core or any subclass
	    thereof.

  source    Specifies the root widget of the widget tree from which the actions of any descendant widget can be invoked when events occur  in
	    destination.  Must be of class Core or any subclass thereof.

Description
  XtInstallAllAccelerators()  is  a  convenience function for installing all accelerators from a widget and all its descendants onto a single
  destination widget.  It recursively traverses the widget tree rooted at source and installs the accelerator resource values of each  widget
  onto destination.  It also calls the display_accelerator() method of each widget in the source tree that has one.

Usage
  A  common use for XtInstallAllAccelerators() is to install the accelerators for all the buttons of a menu or an entire menu bar onto a sin-
  gle destination widget.  The XtNaccelerator resource of each button would be specified when the button was created or would come  from  the
  resource database, and the single call to XtInstallAllAccelerators() would make all those accelerators available in a widget.

  Note	that  if you want to provide keyboard shortcuts for a menu system from within two different text widgets, you will have to call XtIn-
  stallAllAccelerators() twice.

  Also note that if a widget is not interested in events of a certain type, then those events will propagate up the widget hierarchy  to  the
  first  ancestor  widget that is interested.  If your interface contains a composite widget that contains only button and other widgets that
  are not interested in keyboard input, then you can install a set of keyboard accelerators on the composite widget, and they will be invoked
  when keyboard events occur anywhere within that widget.

See Also
  XtInstallAccelerators(1),
  display_accelerator(4).

Xt - Translations and Actions												XtInstallAllAccelerators()