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
direction of focus movement
TRUE is returned, stay in the widget, the failed keyboard
navigation is Ok and/or there is nowhere we can/should move the
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
GTK_DIR_TAB_BACKWARD. For the other
GtkDirectionType, it looks at the
"gtk-keynav-cursor-only" setting and returns
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
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.
TRUE if stopping keyboard navigation is fine,
if the emitting widget should try to handle the keyboard
navigation attempt in its parent container(s).
Derived by RGtkGen from GTK+ documentation
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.