From 758137b5d9623fc1cd52c818d7896d37dbde14a2 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Timm=20B=C3=A4der?= Date: Sun, 3 Jun 2018 11:32:09 +0200 Subject: [PATCH] widget: Add docs for {get,set}_focus_child With get_ being still private. --- docs/reference/gtk/gtk4-sections.txt | 1 + gtk/gtkwidget.c | 24 ++++++++++++++++++++++-- 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt index 34c9d6b030..aef56e724e 100644 --- a/docs/reference/gtk/gtk4-sections.txt +++ b/docs/reference/gtk/gtk4-sections.txt @@ -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 diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 3e5864df06..ac2e6bd656 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -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) { -- 2.30.2