gtk-container-focus-chain (container)

container -- a gtk-container widget
focusable -- a list of gtk-widget objects representing the focus chain

Accessor of the focus chain widgets of the container.

The gtk-container-focus-chain function retrieves the focus chain of the container, if one has been set explicitly. If no focus chain has been explicitly set, GTK computes the focus chain based on the positions of the children. In that case, GTK returns false. The (setf gtk-container-focus-chain) function sets a focus chain, overriding the one computed automatically by GTK.

In principle each widget in the chain should be a descendant of the container, but this is not enforced by this method, since it is allowed to set the focus chain before you pack the widgets, or have a widget in the chain that is not always packed. The necessary checks are done when the focus chain is actually traversed. The gtk-container-focus-chain function has been deprecated since version 3.24 and should not be used in newly written code. For overriding focus behavior, use the "focus" signal.