NAME
XtSetKeyboardFocus - focus events on a child widget
SYNTAX
XtSetKeyboardFocus(Widget _s_u_b_t_r_e_e, Widget _d_e_s_c_e_n_d_a_n_t);
ARGUMENTS
-
_s_u_b_t_r_e_e
Specifies either the widget in the subtree structure which is to receive the
-
keyboard event, or
_N_o_n_e.
Note that it is not an error to specify
_N_o_n_e
when no input focus was previously set.
-
_d_e_s_c_e_n_d_a_n_t
Specifies the widget for which the keyboard focus is to be set.
-
DESCRIPTION
If a future
_K_e_y_P_r_e_s_s
or
_K_e_y_R_e_l_e_a_s_e
event occurs within the specified subtree,
_X_t_S_e_t_K_e_y_b_o_a_r_d_F_o_c_u_s
causes
_X_t_D_i_s_p_a_t_c_h_E_v_e_n_t
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:
-
·
W has the X input focus.
-
-
·
W has the keyboard focus of one of its ancestors,
-
and the event occurs within the ancestor or one of the ancestor's descendants.
-
·
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
_T_r_u_e.
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
_F_o_c_u_s_I_n
event is generated for the descendant if
_F_o_c_u_s_N_o_t_i_f_y
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
_F_o_c_u_s_O_u_t
event is generated for descendant if
_F_o_c_u_s_N_o_t_i_f_y
events have been selected by the descendant.
SEE ALSO
XtCallAcceptFocus(3Xt)
_X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e