AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

widget: Add docs for {get,set}_focus_child

Browse Source 
With get_ being still private.
This commit is contained in:
Timm Bäder 2018-06-03 11:32:09 +02:00
parent 4ab3aada3f
commit 758137b5d9
2 changed files with 23 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gtk/gtk4-sections.txt
View File

@ -4334,6 +4334,7 @@ gtk_widget_get_can_focus
gtk_widget_set_can_focus
gtk_widget_get_focus_on_click
gtk_widget_set_focus_on_click
gtk_widget_set_focus_child
gtk_widget_get_has_surface
gtk_widget_set_has_surface
gtk_widget_get_sensitive

24
gtk/gtkwidget.c
View File

@ -13330,6 +13330,19 @@ gtk_widget_snapshot_child (GtkWidget *widget,
gtk_snapshot_offset (snapshot, -x, -y);
}
/**
* gtk_widget_set_focus_child:
* @widget: a #GtkWidget
* @child: (nullable): a direct child widget of @widget or %NULL
* to unset the focus child of @widget
*
* Set @child as the current focus child of @widget. The previous
* focus child will be unset.
*
* This function is only suitable for widget implementations.
* If you want a certain widget to get the input focus, call
* gtk_widget_grab_focus() on it.
*/
void
gtk_widget_set_focus_child (GtkWidget *widget,
GtkWidget *child)
@ -13364,10 +13377,17 @@ gtk_widget_set_focus_child (GtkWidget *widget,
if (GTK_IS_CONTAINER (widget))
gtk_container_set_focus_child (GTK_CONTAINER (widget), child);
/* TODO: ??? */
}
/**
* gtk_widget_get_focus_child:
* @widget: a #GtkWidget
*
* Returns the current focus child of @widget.
*
* Returns: (nullable): The current focus child of @widget,
* or %NULL in case the focus child is unset.
*/
GtkWidget *
gtk_widget_get_focus_child (GtkWidget *widget)
{