[gtk+/composite-templates] Add an example for handling app menu fallback

[Juan Pablo Ugarte <jpu src gnome org>]

commit b42fae600e77a23a51f137139dafc340d9d7dd38
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Jul 22 21:01:15 2012 -0400

    Add an example for handling app menu fallback
    
    The example shows how to use a menu button instead of the default
    menubar when the shell doesn't show the app menu.

 examples/Makefile.am       |    3 +-
 examples/sunny.c           |  213 ++++++++++++++++++++++++++++++++++++++++++++
 gtk/gtkapplicationwindow.c |    8 ++
 3 files changed, 223 insertions(+), 1 deletions(-)
---
diff --git a/examples/Makefile.am b/examples/Makefile.am
index f4d2f74..4637c9c 100644
--- a/examples/Makefile.am
+++ b/examples/Makefile.am
@@ -53,7 +53,8 @@ noinst_PROGRAMS = \
 	hello-world				\
 	window-default				\
 	bloatpad				\
-	plugman				\
+	plugman					\
+	sunny					\
 	grid-packing				\
 	drawing					\
 	builder
diff --git a/examples/sunny.c b/examples/sunny.c
new file mode 100644
index 0000000..524b898
--- /dev/null
+++ b/examples/sunny.c
@@ -0,0 +1,213 @@
+#include <stdlib.h>
+#include <gtk/gtk.h>
+
+static void
+new_window (GApplication *app,
+            GFile        *file)
+{
+  GtkWidget *window, *scrolled, *view, *overlay;
+  GtkSettings *settings;
+  gboolean appmenu;
+
+  window = gtk_application_window_new (GTK_APPLICATION (app));
+  gtk_application_window_set_show_menubar (GTK_APPLICATION_WINDOW (window), FALSE);
+  gtk_window_set_default_size ((GtkWindow*)window, 640, 480);
+  gtk_window_set_title (GTK_WINDOW (window), "Sunny");
+
+  overlay = gtk_overlay_new ();
+  gtk_container_add (GTK_CONTAINER (window), overlay);
+
+  settings = gtk_settings_get_default ();
+  g_object_get (settings, "gtk-shell-shows-app-menu", &appmenu, NULL);
+  if (!appmenu)
+    {
+      GMenuModel *model;
+      GtkWidget *menu;
+      GtkWidget *image;
+
+      model = gtk_application_get_app_menu (GTK_APPLICATION (app));
+      menu = gtk_menu_button_new ();
+      gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (menu), model);
+      gtk_widget_set_halign (menu, GTK_ALIGN_END);
+      gtk_widget_set_valign (menu, GTK_ALIGN_START);
+      image = gtk_image_new ();
+      gtk_image_set_from_icon_name (GTK_IMAGE (image),
+                                    "sunny",
+                                    GTK_ICON_SIZE_MENU);
+      gtk_button_set_image (GTK_BUTTON (menu), image);
+      gtk_overlay_add_overlay (GTK_OVERLAY (overlay), menu);
+    }
+
+  scrolled = gtk_scrolled_window_new (NULL, NULL);
+  gtk_widget_set_hexpand (scrolled, TRUE);
+  gtk_widget_set_vexpand (scrolled, TRUE);
+  view = gtk_text_view_new ();
+
+  gtk_container_add (GTK_CONTAINER (scrolled), view);
+  gtk_container_add (GTK_CONTAINER (overlay), scrolled);
+
+  if (file != NULL)
+    {
+      gchar *contents;
+      gsize length;
+
+      if (g_file_load_contents (file, NULL, &contents, &length, NULL, NULL))
+        {
+          GtkTextBuffer *buffer;
+
+          buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
+          gtk_text_buffer_set_text (buffer, contents, length);
+          g_free (contents);
+        }
+    }
+
+  gtk_widget_show_all (GTK_WIDGET (window));
+}
+
+static void
+activate (GApplication *application)
+{
+  new_window (application, NULL);
+}
+
+static void
+open (GApplication  *application,
+      GFile        **files,
+      gint           n_files,
+      const gchar   *hint)
+{
+  gint i;
+
+  for (i = 0; i < n_files; i++)
+    new_window (application, files[i]);
+}
+
+typedef GtkApplication MenuButton;
+typedef GtkApplicationClass MenuButtonClass;
+
+G_DEFINE_TYPE (MenuButton, menu_button, GTK_TYPE_APPLICATION)
+
+static void
+show_about (GSimpleAction *action,
+            GVariant      *parameter,
+            gpointer       user_data)
+{
+  gtk_show_about_dialog (NULL,
+                         "program-name", "Sunny",
+                         "title", "About Sunny",
+                         "logo-icon-name", "sunny",
+                         "comments", "A cheap Bloatpad clone.",
+                         NULL);
+}
+
+
+static void
+quit_app (GSimpleAction *action,
+          GVariant      *parameter,
+          gpointer       user_data)
+{
+  GList *list, *next;
+  GtkWindow *win;
+
+  g_print ("Going down...\n");
+
+  list = gtk_application_get_windows (GTK_APPLICATION (g_application_get_default ()));
+  while (list)
+    {
+      win = list->data;
+      next = list->next;
+
+      gtk_widget_destroy (GTK_WIDGET (win));
+
+      list = next;
+    }
+}
+
+static void
+new_activated (GSimpleAction *action,
+               GVariant      *parameter,
+               gpointer       user_data)
+{
+  GApplication *app = user_data;
+
+  g_application_activate (app);
+}
+
+static GActionEntry app_entries[] = {
+  { "about", show_about, NULL, NULL, NULL },
+  { "quit", quit_app, NULL, NULL, NULL },
+  { "new", new_activated, NULL, NULL, NULL }
+};
+
+static void
+startup (GApplication *application)
+{
+  GtkBuilder *builder;
+
+  G_APPLICATION_CLASS (menu_button_parent_class)->startup (application);
+
+  g_action_map_add_action_entries (G_ACTION_MAP (application), app_entries, G_N_ELEMENTS (app_entries), application);
+
+  builder = gtk_builder_new ();
+  gtk_builder_add_from_string (builder,
+                               "<interface>"
+                               "  <menu id='app-menu'>"
+                               "    <section>"
+                               "      <item>"
+                               "        <attribute name='label' translatable='yes'>_New Window</attribute>"
+                               "        <attribute name='action'>app.new</attribute>"
+                               "      </item>"
+                               "      <item>"
+                               "        <attribute name='label' translatable='yes'>_About Sunny</attribute>"
+                               "        <attribute name='action'>app.about</attribute>"
+                               "      </item>"
+                               "      <item>"
+                               "        <attribute name='label' translatable='yes'>_Quit</attribute>"
+                               "        <attribute name='action'>app.quit</attribute>"
+                               "        <attribute name='accel'>&lt;Primary&gt;q</attribute>"
+                               "      </item>"
+                               "    </section>"
+                               "  </menu>"
+                               "</interface>", -1, NULL);
+  gtk_application_set_app_menu (GTK_APPLICATION (application), G_MENU_MODEL (gtk_builder_get_object (builder, "app-menu")));
+  g_object_unref (builder);
+}
+
+static void
+menu_button_init (MenuButton *app)
+{
+}
+
+static void
+menu_button_class_init (MenuButtonClass *class)
+{
+  GApplicationClass *application_class = G_APPLICATION_CLASS (class);
+
+  application_class->startup = startup;
+  application_class->activate = activate;
+  application_class->open = open;
+}
+
+MenuButton *
+menu_button_new (void)
+{
+  g_type_init ();
+
+  return g_object_new (menu_button_get_type (),
+                       "application-id", "org.gtk.Test.Sunny",
+                       "flags", G_APPLICATION_HANDLES_OPEN,
+                       NULL);
+}
+
+int
+main (int argc, char **argv)
+{
+  MenuButton *menu_button;
+  int status;
+
+  menu_button = menu_button_new ();
+  status = g_application_run (G_APPLICATION (menu_button), argc, argv);
+  g_object_unref (menu_button);
+
+  return status;
+}
diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index 9b27edf..fff5380 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -107,6 +107,14 @@
  * </programlisting>
  * </example>
  *
+ * <example><title>Handling fallback yourself</title>
+ * <programlisting>
+ * <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; parse="text" href="../../../../examples/sunny.c">
+ *  <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
+ * </xi:include>
+ * </programlisting>
+ * </example>
+ *
  * The XML format understood by #GtkBuilder for #GMenuModel consists
  * of a toplevel <tag class="starttag">menu</tag> element, which contains
  * one or more <tag class="starttag">item</tag> elements. Each