[gtk/matthiasc/for-master: 5/5] docs: Add GtkOverlay to the widget gallery

[Matthias Clasen <matthiasc src gnome org>]

commit 5fe837483c4a4ecf5b4e1be538015dbd0c39a2fe
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Oct 27 00:42:38 2020 -0400

    docs: Add GtkOverlay to the widget gallery

 docs/reference/gtk/images/overlay.png | Bin 0 -> 5973 bytes
 docs/reference/gtk/meson.build        |   1 +
 docs/reference/gtk/visual_index.xml   |   1 +
 docs/tools/widgets.c                  |  40 ++++++++++++++++++++++++++++++++++
 4 files changed, 42 insertions(+)
---
diff --git a/docs/reference/gtk/images/overlay.png b/docs/reference/gtk/images/overlay.png
new file mode 100644
index 0000000000..e61605a95c
Binary files /dev/null and b/docs/reference/gtk/images/overlay.png differ
diff --git a/docs/reference/gtk/meson.build b/docs/reference/gtk/meson.build
index 6ae52d356a..75f4b8fb67 100644
--- a/docs/reference/gtk/meson.build
+++ b/docs/reference/gtk/meson.build
@@ -338,6 +338,7 @@ images = [
   'images/multiline-text.png',
   'images/notebook.png',
   'images/options.png',
+  'images/overlay.png',
   'images/pagesetupdialog.png',
   'images/panes.png',
   'images/password-entry.png',
diff --git a/docs/reference/gtk/visual_index.xml b/docs/reference/gtk/visual_index.xml
index e1c8883c32..46efd6a343 100644
--- a/docs/reference/gtk/visual_index.xml
+++ b/docs/reference/gtk/visual_index.xml
@@ -82,6 +82,7 @@
     <link linkend="GtkFlowBox"><inlinegraphic fileref="flow-box.png" format="PNG"></inlinegraphic></link>
     <link linkend="GtkTreeView"><inlinegraphic fileref="list-and-tree.png" 
format="PNG"></inlinegraphic></link>
     <link linkend="GtkIconView"><inlinegraphic fileref="icon-view.png" format="PNG"></inlinegraphic></link>
+    <link linkend="GtkOverlay"><inlinegraphic fileref="overlay.png" format="PNG"></inlinegraphic></link>
     <link linkend="GtkStack"><inlinegraphic fileref="stack.png" format="PNG"></inlinegraphic></link>
     <link linkend="GtkStackSwitcher"><inlinegraphic fileref="stackswitcher.png" 
format="PNG"></inlinegraphic></link>
     <link linkend="GtkStackSidebar"><inlinegraphic fileref="sidebar.png" format="PNG"></inlinegraphic></link>
diff --git a/docs/tools/widgets.c b/docs/tools/widgets.c
index 6dedd9036a..51889d8e96 100644
--- a/docs/tools/widgets.c
+++ b/docs/tools/widgets.c
@@ -2072,6 +2072,45 @@ create_grid (void)
   return new_widget_info ("grid", vbox, MEDIUM);
 }
 
+static WidgetInfo *
+create_overlay (void)
+{
+  GtkWidget *vbox;
+  WidgetInfo *info;
+  GtkWidget *widget;
+  GtkWidget *overlay;
+  GtkWidget *label;
+  GtkWidget *child;
+
+  widget = gtk_frame_new (NULL);
+  overlay = gtk_overlay_new ();
+  gtk_widget_add_css_class (widget, "view");
+  label = gtk_label_new ("Content");
+  gtk_widget_set_vexpand (label, TRUE);
+  gtk_frame_set_child (GTK_FRAME (widget), overlay);
+  gtk_overlay_set_child (GTK_OVERLAY (overlay), label);
+
+  child = gtk_frame_new (NULL);
+  gtk_widget_add_css_class (child, "app-notification");
+  gtk_frame_set_child (GTK_FRAME (child), gtk_label_new ("Overlay"));
+  gtk_widget_set_valign (child, GTK_ALIGN_START);
+  gtk_widget_set_halign (child, GTK_ALIGN_CENTER);
+  gtk_overlay_add_overlay (GTK_OVERLAY (overlay), child);
+
+  vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, 6);
+  gtk_widget_set_halign (widget, GTK_ALIGN_FILL);
+  gtk_widget_set_valign (widget, GTK_ALIGN_FILL);
+
+  gtk_box_append (GTK_BOX (vbox), widget);
+  gtk_box_append (GTK_BOX (vbox), gtk_label_new ("Overlay"));
+
+  add_margin (vbox);
+
+  info = new_widget_info ("overlay", vbox, MEDIUM);
+
+  return info;
+}
+
 GList *
 get_all_widgets (void)
 {
@@ -2161,6 +2200,7 @@ get_all_widgets (void)
   retval = g_list_prepend (retval, create_box ());
   retval = g_list_prepend (retval, create_center_box ());
   retval = g_list_prepend (retval, create_grid ());
+  retval = g_list_prepend (retval, create_overlay ());
 
   return retval;
 }