Widget.childFocus

Called by widgets as the user moves around the window using keyboard shortcuts.

The @direction argument indicates what kind of motion is taking place (up, down, left, right, tab forward, tab backward).

This function calls the [vfunc@Gtk.Widget.focus] virtual function; widgets can override the virtual function in order to implement appropriate focus behavior.

The default focus() virtual function for a widget should return TRUE if moving in @direction left the focus on a focusable location inside that widget, and FALSE if moving in @direction moved the focus outside the widget. When returning TRUE, widgets normallycall [method@Gtk.Widget.grab_focus] to place the focus accordingly; when returning FALSE, they don’t modify the current focus location.

This function is used by custom widget implementations; if you're writing an app, you’d use [method@Gtk.Widget.grab_focus] to move the focus to a particular widget.

class Widget
bool
childFocus

Parameters

direction GtkDirectionType

direction of focus movement

Return Value

Type: bool

%TRUE if focus ended up inside @widget

Meta