XtSetKeyboardFocus(3Xt)AIX (XT FUNCTIONS) XtSetKeyboardFocus(3Xt) NAME XtSetKeyboardFocus - focus events on a child widget SYNTAX XtSetKeyboardFocus(_s_u_b_t_r_e_e, _d_e_s_c_e_n_d_a_n_t) Widget _s_u_b_t_r_e_e, _d_e_s_c_e_n_d_a_n_t; ARGUMENTS _d_e_s_c_e_n_d_a_n_t Specifies either the widget in the subtree struc- ture 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. _w 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 wid- get. 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 _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 key- board 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 Rev. Release 3 Page 1