[libadwaita/wip/exalm/view-stack] view-stack: Add add_titled_with_icon()

[Alexander Mikhaylenko <alexm src gnome org>]

commit 84aa3c13689e5a60b640a73160a293297a0317d2
Author: Alexander Mikhaylenko <alexm gnome org>
Date:   Wed Aug 3 14:29:29 2022 +0400

    view-stack: Add add_titled_with_icon()
    
    Fixes https://gitlab.gnome.org/GNOME/libadwaita/-/issues/485

 src/adw-view-stack.c | 43 +++++++++++++++++++++++++++++++++++++------
 src/adw-view-stack.h |  6 ++++++
 2 files changed, 43 insertions(+), 6 deletions(-)
---
diff --git a/src/adw-view-stack.c b/src/adw-view-stack.c
index ca3f43e1..40c1e816 100644
--- a/src/adw-view-stack.c
+++ b/src/adw-view-stack.c
@@ -683,7 +683,8 @@ static AdwViewStackPage *
 add_internal (AdwViewStack *self,
               GtkWidget    *child,
               const char   *name,
-              const char   *title)
+              const char   *title,
+              const char   *icon_name)
 {
   AdwViewStackPage *page;
 
@@ -693,7 +694,7 @@ add_internal (AdwViewStack *self,
   page->widget = g_object_ref (child);
   page->name = g_strdup (name);
   page->title = g_strdup (title);
-  page->icon_name = NULL;
+  page->icon_name = g_strdup (icon_name);
   page->needs_attention = FALSE;
   page->last_focus = NULL;
 
@@ -988,7 +989,7 @@ adw_view_stack_buildable_add_child (GtkBuildable *buildable,
   if (ADW_IS_VIEW_STACK_PAGE (child))
     add_page (self, ADW_VIEW_STACK_PAGE (child));
   else if (GTK_IS_WIDGET (child))
-    add_internal (self, GTK_WIDGET (child), NULL, NULL);
+    add_internal (self, GTK_WIDGET (child), NULL, NULL, NULL);
   else
     parent_buildable_iface->add_child (buildable, builder, child, type);
 }
@@ -1376,7 +1377,7 @@ adw_view_stack_add (AdwViewStack   *self,
   g_return_val_if_fail (ADW_IS_VIEW_STACK (self), NULL);
   g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
 
-  return add_internal (self, child, NULL, NULL);
+  return add_internal (self, child, NULL, NULL, NULL);
 }
 
 /**
@@ -1401,7 +1402,7 @@ adw_view_stack_add_named (AdwViewStack   *self,
   g_return_val_if_fail (ADW_IS_VIEW_STACK (self), NULL);
   g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
 
-  return add_internal (self, child, name, NULL);
+  return add_internal (self, child, name, NULL, NULL);
 }
 
 /**
@@ -1429,7 +1430,37 @@ adw_view_stack_add_titled (AdwViewStack   *self,
   g_return_val_if_fail (ADW_IS_VIEW_STACK (self), NULL);
   g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
 
-  return add_internal (self, child, name, title);
+  return add_internal (self, child, name, title, NULL);
+}
+
+/**
+ * adw_view_stack_add_titled_with_icon:
+ * @self: a view stack
+ * @child: the widget to add
+ * @name: (nullable): the name for @child
+ * @title: a human-readable title for @child
+ * @icon_name: an icon name for @child
+ *
+ * Adds a child to @self.
+ *
+ * The child is identified by the @name. The @title and @icon_name will be used
+ * by [class@ViewSwitcher] to represent @child.
+ *
+ * Returns: (transfer none): the `AdwViewStackPage` for @child
+ *
+ * Since: 1.2
+ */
+AdwViewStackPage *
+adw_view_stack_add_titled_with_icon (AdwViewStack *self,
+                                     GtkWidget    *child,
+                                     const char   *name,
+                                     const char   *title,
+                                     const char   *icon_name)
+{
+  g_return_val_if_fail (ADW_IS_VIEW_STACK (self), NULL);
+  g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
+
+  return add_internal (self, child, name, title, icon_name);
 }
 
 /**
diff --git a/src/adw-view-stack.h b/src/adw-view-stack.h
index bda0f6af..ae55ee23 100644
--- a/src/adw-view-stack.h
+++ b/src/adw-view-stack.h
@@ -91,6 +91,12 @@ AdwViewStackPage *adw_view_stack_add_titled (AdwViewStack *self,
                                              GtkWidget    *child,
                                              const char   *name,
                                              const char   *title);
+ADW_AVAILABLE_IN_1_2
+AdwViewStackPage *adw_view_stack_add_titled_with_icon (AdwViewStack *self,
+                                                       GtkWidget    *child,
+                                                       const char   *name,
+                                                       const char   *title,
+                                                       const char   *icon_name);
 
 ADW_AVAILABLE_IN_ALL
 void adw_view_stack_remove (AdwViewStack *self,