gtk-widget-child-focus (widget direction)

widget -- a gtk-widget object
direction -- a gtk-direction-type value with the direction of focus movement

True if focus ended up inside widget.

This function is used by custom widget implementations. If you are writing an application, you would use the gtk-widget-grab-focus function to move the focus to a particular widget, and the gtk-container-set-focus-chain function to change the focus tab order. So you may want to investigate those functions instead.

The gtk-widget-child-focus function is called by containers 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). The gtk-widget-child-focus function emits the "focus" signal. Widgets override the default handler for this signal in order to implement appropriate focus behavior.

The default "focus" handler 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. If returning true, widgets normally call the gtk-widget-grab-focus function to place the focus accordingly. If returning false, they do not modify the current focus location.