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