[gtk+] GtkStack: add gtk_stack_get_child_by_name()

[Steve Frécinaux <sfre src gnome org>]

commit 49bf3cdba8b779d36ad776379921204b2387a02e
Author: Steve Frécinaux <code istique net>
Date:   Mon Jan 20 09:32:37 2014 +0100

    GtkStack: add gtk_stack_get_child_by_name()
    
    This new method allows getting a widget from a GtkStack when we know its
    name, and will also return NULL if there is no widget going by that
    name.
    
    Usage example would be to check if a child with a given name exists
    before calling gtk_stack_set_visible_child_name().
    
    https://bugzilla.gnome.org/show_bug.cgi?id=722588

 gtk/gtkstack.c |   34 ++++++++++++++++++++++++++++++++++
 gtk/gtkstack.h |    3 +++
 2 files changed, 37 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkstack.c b/gtk/gtkstack.c
index 1c61192..f158d13 100644
--- a/gtk/gtkstack.c
+++ b/gtk/gtkstack.c
@@ -1134,6 +1134,40 @@ gtk_stack_remove (GtkContainer *container,
 }
 
 /**
+ * gtk_stack_get_child_by_name:
+ * @stack: a #GtkStack
+ * @name: the name of the child to find
+ *
+ * Finds the child of the #GtkStack with the name given as
+ * the argument. Returns %NULL if there is no child with this
+ * name.
+ *
+ * Return value: (transfer none): the requested child of the #GtkStack
+ *
+ * Since: 3.12
+ */
+GtkWidget *
+gtk_stack_get_child_by_name (GtkStack    *stack,
+                             const gchar *name)
+{
+  GtkStackPrivate *priv = gtk_stack_get_instance_private (stack);
+  GtkStackChildInfo *info;
+  GList *l;
+
+  g_return_val_if_fail (GTK_IS_STACK (stack), NULL);
+  g_return_val_if_fail (name != NULL, NULL);
+
+  for (l = priv->children; l != NULL; l = l->next)
+    {
+      info = l->data;
+      if (info->name && strcmp (info->name, name) == 0)
+        return info->widget;
+    }
+
+  return NULL;
+}
+
+/**
  * gtk_stack_set_homogeneous:
  * @stack: a #GtkStack
  * @homogeneous: %TRUE to make @stack homogeneous
diff --git a/gtk/gtkstack.h b/gtk/gtkstack.h
index d0bb471..edecf7f 100644
--- a/gtk/gtkstack.h
+++ b/gtk/gtkstack.h
@@ -79,6 +79,9 @@ void                   gtk_stack_add_titled              (GtkStack
                                                           GtkWidget              *child,
                                                           const gchar            *name,
                                                           const gchar            *title);
+GDK_AVAILABLE_IN_3_12
+GtkWidget *            gtk_stack_get_child_by_name       (GtkStack               *stack,
+                                                          const gchar            *name);
 GDK_AVAILABLE_IN_3_10
 void                   gtk_stack_set_visible_child       (GtkStack               *stack,
                                                           GtkWidget              *child);