gtkWidgetKeynavFailed         package:RGtk2         R Documentation

_g_t_k_W_i_d_g_e_t_K_e_y_n_a_v_F_a_i_l_e_d

_D_e_s_c_r_i_p_t_i_o_n:

     This function should be called whenever keyboard navigation within
     a single widget hits a boundary. The function emits the
     'gtkWidgetKeynavFailed' signal on the widget and its return value
     should be interpreted in a way similar to the return value of
     'gtkWidgetChildFocus':

_U_s_a_g_e:

     gtkWidgetKeynavFailed(object, direction)

_A_r_g_u_m_e_n_t_s:

'object': ['GtkWidget']  a 'GtkWidget'

'direction': ['GtkDirectionType']  direction of focus movement

_D_e_t_a_i_l_s:

     When 'TRUE' is returned, stay in the widget, the failed keyboard
     navigation is Ok and/or there is nowhere we can/should move the
     focus to.

     When 'FALSE' is returned, the caller should continue with keyboard
     navigation outside the widget, e.g. by calling
     'gtkWidgetChildFocus' on the widget's toplevel.

     The default ::keynav-failed handler returns 'TRUE' for 
     'GTK_DIR_TAB_FORWARD' and 'GTK_DIR_TAB_BACKWARD'. For the other 
     values of 'GtkDirectionType', it looks at the 
     '"gtk-keynav-cursor-only"' setting and returns 'FALSE'  if the
     setting is 'TRUE'. This way the entire user interface becomes
     cursor-navigatable on input devices such as mobile phones which
     only have cursor keys but no tab key.

     Whenever the default handler returns 'TRUE', it also calls
     'gtkWidgetErrorBell' to notify the user of the failed keyboard
     navigation.

     A use case for providing an own implementation of ::keynav-failed 
     (either by connecting to it or by overriding it) would be a row of
     'GtkEntry' widgets where the user should be able to navigate the
     entire row with the cursor keys, as e.g. known from user
     interfaces  that require entering license keys.  

     Since  2.12

_V_a_l_u_e:

     [logical] 'TRUE' if stopping keyboard navigation is fine, 'FALSE'
     if the emitting widget should try to handle the keyboard
     navigation attempt in its parent container(s).

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

