home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtsetkeyboardfocus.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  2.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtSetKeyboardFocus(3Xt)       XT FUNCTIONS      XtSetKeyboardFocus(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtSetKeyboardFocus - focus events on a child widget
  9.  
  10. SSYYNNTTAAXX
  11.        XtSetKeyboardFocus(_s_u_b_t_r_e_e _d_e_s_c_e_n_d_a_n_t)
  12.         Widget _s_u_b_t_r_e_e, _d_e_s_c_e_n_d_a_n_t;
  13.  
  14. AARRGGUUMMEENNTTSS
  15.        _d_e_s_c_e_n_d_a_n_t
  16.          Specifies either the widget in the subtree
  17.          structure which is to receive the keyboard
  18.          event, or _N_o_n_e.  Note that it is not an error to
  19.          specify _N_o_n_e when no input focus was previously
  20.          set.
  21.  
  22.        _w     Specifies the widget for which the keyboard
  23.          focus is to be set.
  24.  
  25. DDEESSCCRRIIPPTTIIOONN
  26.        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
  27.        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_-
  28.        _p_a_t_c_h_E_v_e_n_t to remap and send the event to the specified
  29.        descendant widget.
  30.  
  31.        When there is no modal cascade, keyboard events can occur
  32.        within a widget W in one of three ways:
  33.  
  34.        +o    W has the X input focus.
  35.  
  36.        +o    W has the keyboard focus of one of its ancestors, and
  37.         the event occurs within the ancestor or one of the
  38.         ancestor's descendants.
  39.  
  40.        +o    No ancestor of W has a descendant within the keyboard
  41.         focus, and the pointer is within W.
  42.  
  43.        When there is a modal cascade, a widget W receives key-
  44.        board events if an ancestor of W is in the active subset
  45.        of the modal cascade and one or more of the previous con-
  46.        ditions is _T_r_u_e.
  47.  
  48.        When subtree or one of its descendants acquires the X
  49.        input focus or the pointer moves into the subtree such
  50.        that keyboard events would now be delivered to subtree, a
  51.        _F_o_c_u_s_I_n event is generated for the descendant if _F_o_c_u_s_N_o_-
  52.        _t_i_f_y events have been selected by the descendant.  Simi-
  53.        larly, when W loses the X input focus or the keyboard
  54.        focus for one of its ancestors, a _F_o_c_u_s_O_u_t event is gener-
  55.        ated for descendant if _F_o_c_u_s_N_o_t_i_f_y events have been
  56.        selected by the descendant.
  57.  
  58. SSEEEE AALLSSOO
  59.        XtCallAcceptFocus(3Xt)
  60.        _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
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtSetKeyboardFocus(3Xt)       XT FUNCTIONS      XtSetKeyboardFocus(3Xt)
  71.  
  72.  
  73.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.