Gtk.Widget.child_focus

### Method

# Gtk Widgetchild_focus

#### Declaration [src]

    gboolean
    gtk_widget_child_focus (
      GtkWidget* widget,
      GtkDirectionType direction
    )

#### Description [src]

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 `Gtk.WidgetClass.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 normally call `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 `gtk_widget_grab_focus()` to move the focus to a particular widget.

#### Parameters

`direction` | `GtkDirectionType`
| Direction of focus movement.

#### Return value

Returns: | `gboolean`
| `TRUE` if focus ended up inside `widget`.