Method

GtkContainerget_focus_chain

deprecated: 3.24

Declaration [src]

gboolean
gtk_container_get_focus_chain (
  GtkContainer* container,
  GList** focusable_widgets
)

Description [src]

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+ stores NULL in focusable_widgets and returns FALSE.

Deprecated since: 3.24

For overriding focus behavior, use the GtkWidgetClass::focus signal.

Parameters

focusable_widgets

Type: A list of GtkWidget*

Location to store the focus chain of the container, or NULL. You should free this list using g_list_free() when you are done with it, however no additional reference count is added to the individual widgets in the focus chain.

The argument will be set by the function.

The caller of the method takes ownership of the returned data container, but not the data inside it.

Return value

Type: gboolean

TRUE if the focus chain of the container has been set explicitly.