


XtSetKeyboardFocus(3Xt)				      XtSetKeyboardFocus(3Xt)
X11R5									X11R5



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 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.

  _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 sub-
  tree,	_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:

  oo++    W has the X input focus.

  o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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 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










