xtcallacceptfocus(1) [hpux man page]

XtCallAcceptFocus()													       XtCallAcceptFocus()

Name
  XtCallAcceptFocus - offer the input focus to a child widget.

Synopsis
  Boolean XtCallAcceptFocus(w, time)
	 Widget w;
	 Time *time;

Inputs
  w	    Specifies the widget; must be of class Core or any subclass thereof.

  time	    Specifies the X time of the event that is causing the accept focus.

Returns
  True if w took the input focus; False if w did not take the input focus.

Description
  XtCallAcceptFocus()  calls  the  specified widget's Core class accept_focus() method, passing it the specified widget and time, and True if
  the widget took the input focus, or False otherwise.	If the accept_focus() method is NULL, XtCallAcceptFocus() returns False.

Usage
  Generally, only widgets should call XtCallAcceptFocus(), and generally only on their descendants.

  Note that calling a widget's accept_focus() method does not automatically assign the input focus, and does not mean that  the  widget  will
  necessarily  take the input focus.  The accept_focus() method must decide whether or not to take the focus and then take it with XSetInput-
  Focus() or XtSetKeyboardFocus().

Background
  Widgets that need the input focus can call XSetInputFocus() explicitly, pursuant to the restrictions	of  the  Inter-Client  Communications
  Convention  Manual.	To  allow  outside  agents,  such  as  the parent, to cause a widget to take the input focus, every widget exports an
  accept_focus() method.  The widget returns a value indicating whether it actually took the focus or not, so that the parent  can  give  the
  focus  to  another widget.  Widgets that need to know when they lose the input focus must use the Xlib focus notification mechanism explic-
  itly (typically by specifying translations for FocusIn and FocusOut events).	Widget classes that never want the input focus should set the
  accept_focus() method to NULL.

See Also
  XtSetKeyboardFocus(1),
  accept_focus(4).

Xt - Keyboard Handling													       XtCallAcceptFocus()

Check Out this Related Man Page

XtSetKeyboardFocus(3)						   XT FUNCTIONS 					     XtSetKeyboardFocus(3)

NAME

       XtSetKeyboardFocus - focus events on a child widget

SYNTAX

       XtSetKeyboardFocus(Widget subtree, Widget descendant);

ARGUMENTS

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

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

DESCRIPTION

       If a future KeyPress or KeyRelease event occurs within the specified subtree, XtSetKeyboardFocus causes XtDispatchEvent 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 True.

       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 FocusIn event is generated for the descendant if FocusNotify events have been selected by the descendant.  Simi-
       larly, when W loses the X input focus or the keyboard focus for one of its ancestors, a FocusOut event is generated for descendant if
       FocusNotify events have been selected by the descendant.

SEE ALSO

       XtCallAcceptFocus(3)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.1.3 					     XtSetKeyboardFocus(3)

Linux and UNIX Man Pages

xtcallacceptfocus(1) [hpux man page]

Check Out this Related Man Page