XtCallAcceptFocus()XtCallAcceptFocus()NameXtCallAcceptFocus - 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.
DescriptionXtCallAcceptFocus() 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 automati‐
cally 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 XSet‐
InputFocus() or XtSetKeyboardFocus().
Background
Widgets that need the input focus can call XSetInputFocus() explicitly,
pursuant to the restrictions of the Inter-Client Communications Conven‐
tion 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 wid‐
get. Widgets that need to know when they lose the input focus must use
the Xlib focus notification mechanism explicitly (typically by specify‐
ing translations for FocusIn and FocusOut events). Widget classes that
never want the input focus should set the accept_focus() method to
NULL.
See AlsoXtSetKeyboardFocus(1),
accept_focus(4).
Xt - Keyboard Handling XtCallAcceptFocus()
