xtsetkeyboardfocus(1) [hpux man page]

XtSetKeyboardFocus()													      XtSetKeyboardFocus()

Name
  XtSetKeyboardFocus - redirect keyboard input to a widget.

Synopsis
  void XtSetKeyboardFocus(subtree descendant)
	 Widget subtree, descendant;

Inputs
  subtree   Specifies  the  widget to be considered the root of the subtree for which the keyboard focus is to be set.	Must be of class Core
	    or any subclass thereof.

  descendant
	    Specifies a normal (non-popup) descendant of subtree to which keyboard events are to be redirected, or None.   May	be  of	class
	    Object or any subclass thereof.

Description
  XtSetKeyboardFocus() causes XtDispatchEvent() to remap keyboard events that occur within the widget hierarchy rooted at subtree and to dis-
  patch them to descendant.  If descendant is not a subclass of Core, it is replaced by its closest  windowed  ancestor.   If  descendant  is
  None, keyboard events within subtree will be dispatched normally.

  When subtree or one of its descendants acquires the X keyboard focus, or the pointer moves into the subtree such that keyboard events would
  now be delivered to subtree, a FocusIn event is generated for descendant if FocusChange events have been  selected  by  descendant.	Simi-
  larly, when subtree loses the X keyboard focus or the keyboard focus for one of its ancestors, a FocusOut event is generated for descendant
  if FocusChange events have been selected by descendant.

  For more details on how events are dispatched after a call to XtSetKeyboardFocus(), see XtDispatchEvent().

Usage
  XtSetKeyboardFocus() does not call the Xlib function XSetInputFocus(); it simply causes the Intrinsics to dispatch events differently.  For
  most applications, this approach is preferred over the more heavy-handed Xlib function.

Example
  If  a  dialog  box  contains a Label widget, some Button widgets, and a single Text widget for input, it is good style to allow the user to
  enter text into the dialog when the mouse is anywhere over the dialog, not only when the mouse is over the Text widget itself.  This can be
  arranged with code like the following:

     Widget shell, box, text, prompt, ok_button, cancel_button;

     XtPopup(shell, XtGrabExclusive);
     XtSetKeyboardFocus(box, text);

  After  this  call  to  XtSetKeyboardFocus(), whenever the dialog box gets the X input focus (for example, when the mouse moves into it) all
  keyboard events will be redirected at the text widget.

See Also
  XtAddGrab(1), XtDispatchEvent(1).

Xt - Keyboard Handling													      XtSetKeyboardFocus()

Check Out this Related Man Page

XtSetKeyboardFocus(3Xt) MIT X11R4 XtSetKeyboardFocus(3Xt)

Name
XtSetKeyboardFocus - focus events on a child widget

Syntax
XtSetKeyboardFocus(subtree descendant)
Widget subtree, descendant;

Arguments
descendant
Specifies either the widget in the subtree structure which is to receive the keyboard event, or Note that it is not an error to
specify when no input focus was previously set.

w Specifies the widget for which the keyboard focus is to be set.

Description
If a future or event occurs within the specified subtree, causes to remap and send the event to the specified descendant widget.

When there is no modal cascade, keyboard events can occur within a widget W in one of three ways:

o W has the X input focus.

o W has the keyboard focus of one of its ancestors, and the event occurs within the ancestor or one of the ancestor's descendants.

o No ancestor of W has a descendant within the keyboard focus, and the pointer is within W.

When there is a modal cascade, a widget W receives keyboard events if an ancestor of W is in the active subset of the modal cascade and one
or more of the previous conditions is

When subtree or one of its descendants acquires the X input focus or the pointer moves into the subtree such that keyboard events would now
be delivered to subtree, a event is generated for the descendant if events have been selected by the descendant. Similarly, when W loses
the X input focus or the keyboard focus for one of its ancestors, a event is generated for descendant if events have been selected by the
descendant.

See Also
XtCallAcceptFocus(3Xt)
X Window System Toolkit: The Complete Programmer's Guide and Specification, Paul J. Asente and Ralph Swick
X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

XtSetKeyboardFocus(3Xt)

Linux and UNIX Man Pages

xtsetkeyboardfocus(1) [hpux man page]

Check Out this Related Man Page