gtk3 3.0.7 → 3.0.8

data/sample/misc/app-menu.ui

@@ -0,0 +1,19 @@
+<?xml version="1.0"?>
+<interface>
+  <!-- interface-requires gtk+ 3.0 -->
+  <menu id="appmenu">
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_About</attribute>
+        <attribute name="action">app.about</attribute>
+      </item>
+    </section>
+
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_Quit</attribute>
+        <attribute name="action">app.quit</attribute>
+      </item>
+    </section>
+  </menu>
+</interface>

data/sample/misc/button-menu.ui

@@ -0,0 +1,19 @@
+<?xml version="1.0"?>
+<interface>
+  <!-- interface-requires gtk+ 3.0 -->
+  <menu id="buttonmenu">
+    <section>
+      <attribute name="display-hint">horizontal-buttons</attribute>
+      <item>
+        <attribute name="label">Copy</attribute>
+        <attribute name="action">app.copy</attribute>
+        <attribute name="verb-icon">edit-copy-symbolic</attribute>
+      </item>
+      <item>
+        <attribute name="label">Paste</attribute>
+        <attribute name="action">app.paste</attribute>
+        <attribute name="verb-icon">edit-paste-symbolic</attribute>
+      </item>
+    </section>
+  </menu>
+</interface>

data/sample/misc/icons-theme-viewer.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+=begin
+  icons-theme-viewer.rb - Ruby/GTK sample script.
+
+  Copyright (c) 2016 Ruby-GNOME2 Project Team
+  This program is licenced under the same licence as Ruby-GNOME2.
+=end
+
+require "gtk3"
+
+def fill_model(icons)
+  model = Gtk::ListStore.new(String, Gdk::Pixbuf)
+  icons.each do |icon|
+    pixbuf = Gtk::IconTheme.default.load_icon(icon, 32, 0)
+    iter = model.append
+    iter[0] = icon
+    iter[1] = pixbuf
+  end
+  model
+end
+
+def gen_icon_view(pattern, context = nil)
+  icon_theme = Gtk::IconTheme.default
+  icons = icon_theme.icons(context).grep(/#{pattern}/)
+  model = fill_model(icons)
+  icon_view = Gtk::IconView.new(:model => model)
+  icon_view.text_column = 0
+  icon_view.pixbuf_column = 1
+  icon_view
+end
+
+window = Gtk::Window.new("View all your icons")
+window.set_default_size(700, 700)
+window.signal_connect("delete-event") { Gtk.main_quit }
+
+icon_view = gen_icon_view("application")
+sw = Gtk::ScrolledWindow.new(nil, nil)
+sw.add(icon_view)
+
+entry = Gtk::Entry.new
+entry.buffer.text = "application"
+entry.tooltip_text = "Use a pattern to filter icons"
+entry.set_icon_from_icon_name(:secondary, "edit-clear")
+entry.set_icon_tooltip_text(:secondary, "Reset pattern")
+
+entry.signal_connect "icon-release" do |widget, position|
+  widget.buffer.text = "" if position == :secondary
+end
+
+entry.signal_connect "activate" do |widget|
+  sw.remove(icon_view)
+  pattern = widget.buffer.text
+  icon_view = gen_icon_view(pattern)
+  sw.add(icon_view)
+  window.show_all
+end
+
+box = Gtk::Box.new(:vertical, 0)
+box.pack_start(entry)
+box.pack_start(sw, :expand => true, :fill => true)
+
+window.add(box)
+window.show_all
+
+Gtk.main

data/sample/misc/menu.rb

@@ -64,15 +64,15 @@ menubar = Gtk::MenuBar.new
 box1.pack_start(menubar, :expand => false, :fill => true, :padding => 0)
 
 menu = create_menu(2)
-menuitem = Gtk::MenuItem.new("test\nline2")
+menuitem = Gtk::MenuItem.new(:label => "test\nline2")
 menuitem.set_submenu(menu)
 menubar.append(menuitem)
 
-menuitem = Gtk::MenuItem.new("foo")
+menuitem = Gtk::MenuItem.new(:label => "foo")
 menuitem.set_submenu(create_menu(3))
 menubar.append(menuitem)
 
-menuitem = Gtk::MenuItem.new("bar")
+menuitem = Gtk::MenuItem.new(:label => "bar")
 menuitem.set_submenu(create_menu(4))
 menubar.append(menuitem)
 

data/sample/misc/menus_from_resources.gresource.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<gresources>
+  <gresource prefix="/org/gtk/menus_from_resources">
+    <file preprocess="xml-stripblanks">app-menu.ui</file>
+    <file preprocess="xml-stripblanks">toolbar-menu.ui</file>
+    <file preprocess="xml-stripblanks">button-menu.ui</file>
+  </gresource>
+</gresources>

data/sample/misc/menus_from_resources.rb

@@ -0,0 +1,91 @@
+#!/usr/bin/env ruby
+=begin
+  menus_from_resources.rb - Ruby/GTK sample script.
+
+  Copyright (c) 2016 Ruby-GNOME2 Project Team
+  This program is licenced under the same licence as Ruby-GNOME2.
+=end
+
+require "gtk3"
+require "fileutils"
+
+PATH = File.expand_path(File.dirname(__FILE__))
+
+gresource_bin = "#{PATH}/menus_from_resources.gresource"
+gresource_xml = "#{PATH}/menus_from_resources.gresource.xml"
+
+system("glib-compile-resources",
+       "--target", gresource_bin,
+       "--sourcedir", File.dirname(gresource_xml),
+       gresource_xml)
+
+at_exit do
+  FileUtils.rm_f(gresource_bin)
+end
+
+resource = Gio::Resource.load(gresource_bin)
+Gio::Resources.register(resource)
+
+application_instance = Gtk::Application.new("org.gtk.menus_from_resources",
+                                            :non_unique)
+
+application_instance.signal_connect "startup" do |application|
+  %w(about preferences quit copy paste open save close).each do |label|
+    action = Gio::SimpleAction.new(label)
+    action.signal_connect("activate") do |_action, _parameter|
+      puts label
+    end
+    application.add_action(action)
+  end
+  builder = Gtk::Builder.new(:resource => "/org/gtk/menus_from_resources/app-menu.ui")
+  app_menu = builder["appmenu"]
+  application.set_app_menu(app_menu)
+end
+
+application_instance.signal_connect "activate" do |application|
+  window = Gtk::ApplicationWindow.new(application)
+  window.set_default_size(200, 200)
+  window.border_width = 20
+
+  toolbar = Gtk::Toolbar.new
+  toolbar.style = :both
+  toolbutton = Gtk::ToolButton.new(:label => "Open a Menu", :stock_id => Gtk::Stock::OPEN)
+  toolbutton.signal_connect "clicked" do |widget|
+    builder = Gtk::Builder.new(:resource => "/org/gtk/menus_from_resources/toolbar-menu.ui")
+    menu = Gtk::Menu.new(builder["toolbarmenu"])
+    # This method is important, it links the menu to the
+    # Gio::Actions of the Gtk::Application throught one of
+    # its children
+    menu.attach_to_widget(widget)
+
+    menu.show_all
+    event = Gtk.current_event
+    menu.popup(nil, nil, event.button, event.time)
+  end
+  toolbar.insert(toolbutton, 0)
+
+  button = Gtk::Button.new(:label => "Click me")
+  button.signal_connect "clicked" do |widget|
+    builder = Gtk::Builder.new(:resource => "/org/gtk/menus_from_resources/button-menu.ui")
+    menu = Gtk::Popover.new(widget, builder["buttonmenu"])
+    event = Gtk.current_event
+    x, y = event.window.coords_to_parent(event.x,
+                                         event.y)
+    rect = Gdk::Rectangle.new(x - widget.allocation.x,
+                              y - widget.allocation.y,
+                              1,
+                              1)
+    menu.set_pointing_to(rect)
+    menu.show
+  end
+  hbox = Gtk::Box.new(:vertical, 0)
+
+  hbox.pack_start(toolbar, :expand => false, :fill => false)
+  hbox.pack_start(button, :expand => true, :fill => true)
+  window.add(hbox)
+
+  window.show_all
+  window.present
+end
+
+application_instance.run

data/sample/misc/statusicon.rb

@@ -28,7 +28,7 @@ class StatusIconSample < Gtk::StatusIcon
     signal_connect("popup-menu") do |w, button, activate_time|
       menu = Gtk::Menu.new
 
-      menuitem = Gtk::MenuItem.new("Quit")
+      menuitem = Gtk::MenuItem.new(:label => "Quit")
       menuitem.signal_connect("activate") do
         set_visible(false)
         Gtk.main_quit

data/sample/misc/toolbar-menu.ui

@@ -0,0 +1,23 @@
+<?xml version="1.0"?>
+<interface>
+  <!-- interface-requires gtk+ 3.0 -->
+  <menu id="toolbarmenu">
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_Open</attribute>
+        <attribute name="action">app.open</attribute>
+      </item>
+      <item>
+        <attribute name="label" translatable="yes">_Save</attribute>
+        <attribute name="action">app.save</attribute>
+      </item>
+    </section>
+
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_Close</attribute>
+        <attribute name="action">app.close</attribute>
+      </item>
+    </section>
+  </menu>
+</interface>

data/sample/misc/treestore.rb

@@ -0,0 +1,63 @@
+#!/usr/bin/env ruby
+=begin
+  treestore.rb - Gtk::TreeStore sample
+
+  Copyright (c) 2016 Ruby-GNOME2 Project Team
+  This program is licenced under the same licence as Ruby-GNOME2.
+  Based on  https://developer.gnome.org/gtk3/stable/TreeWidget.html
+=end
+
+require "gtk3"
+
+TITLE_COLUMN = 0
+AUTHOR_COLUMN = 1
+CHECKED_COLUMN = 2
+
+model = Gtk::TreeStore.new(String, String, TrueClass)
+iter = model.append(nil)
+iter[TITLE_COLUMN] = "The Principle of Reason"
+iter[AUTHOR_COLUMN] = "Martin Heidegger"
+iter[CHECKED_COLUMN] = false
+
+iter = model.append(nil)
+iter.set_values(["The Art of Computer Programming", "Donald E. Knuth", true])
+
+# append child
+child_iter = model.append(iter)
+child_iter[TITLE_COLUMN] = "Volume 1: Fundamental Algorithms"
+
+# append another child
+child_iter = model.append(iter)
+child_iter.set_value(TITLE_COLUMN, "Volume 2: Seminumerical Algorithms")
+child_iter.set_value(CHECKED_COLUMN, true)
+
+# append another child
+child_iter = model.append(iter)
+child_iter.set_values(["Volume 3: Sorting and Searching",
+                       "Donald E. Knuth",
+                       true])
+
+def treeview_widget_of(model)
+  treeview = Gtk::TreeView.new(model)
+  treeview.append_column(Gtk::TreeViewColumn.new("Title",
+                                                 Gtk::CellRendererText.new,
+                                                 :text => TITLE_COLUMN))
+  treeview.append_column(Gtk::TreeViewColumn.new("Author",
+                                                 Gtk::CellRendererText.new,
+                                                 :text => AUTHOR_COLUMN))
+  treeview.append_column(Gtk::TreeViewColumn.new("Author",
+                                                 Gtk::CellRendererToggle.new,
+                                                 :active => CHECKED_COLUMN))
+  treeview
+end
+
+def display_model(model)
+  win = Gtk::Window.new(:toplevel)
+  win.title = "Simple Gtk::TreeStore"
+  win.add(treeview_widget_of(model))
+  win.show_all
+  win.signal_connect("destroy") { Gtk.main_quit }
+  Gtk.main
+end
+
+display_model(model)

data/sample/tutorial/README.md

@@ -32,6 +32,28 @@ Gtk.main
 ```
 This tutorial will mainly be focused on the use of Gtk::Application, which is the best way to create an application.
 
+## Table of Contents
+*  [Basics](#basics)
+*  [Packing](#packing)
+*  [Building user interfaces](#building-user-interfaces)
+*  [Building Applications](#building-applications)
+  *  [A trivial application](#a trivial application)
+  *  [Populating the window](#populating-the-window)
+    *  [Link a template to a custom class widget](#link-a-template-to-a-custom-class-widget)
+    *  [Load a resource file](#load-a-resource-file)
+  *  [Opening files](#opening-file)
+  *  [An application menu](#an-application-menu)
+    *  [Adding the menu interface](#adding-the-menu-interface)
+    *  [Linking menu items to actions](#linking-menu-items-to-actions)
+    *  [Add accelerators for an action](#add-accelerators-for-an-action)
+  *  [A preference dialog](#a-preference-dialog)
+    *  [Define and store settings for an application with gschemas](#define-and-store-settings-for-an-application-with-gschemas)
+    *  [Configure the settings with a dialog window](#configure-the-settings-with-a-dialog-window)
+  *  [Adding a search bar](#adding-a-search-bar)
+  *  [Adding a sidebar](#adding-a-sidebar)
+  *  [Properties](#properties)
+  *  [Header Bar](#header-bar)
+
 ## Basics
 https://developer.gnome.org/gtk3/stable/gtk-getting-started.html#id-1.2.3.5
 
@@ -54,7 +76,10 @@ puts app.run
 
 ```
 When creating a Gtk::Application you need to pick an application identifier (a name) and input to `Gtk::Application#new` as parameter. For this example *org.gtk.example* is used but for choosing an identifier for your application see this [guide](https://wiki.gnome.org/HowDoI/ChooseApplicationID).
-Lastly `Gtk::Application#new` takes a `Gio::ApplicationFlags` constants as input for your application, if your application would have special needs (those constants can be replaced by theirs respective symbol ie. `Gio::ApplicationFlags::NONE` == `:flags_none`).
+
+Lastly `Gtk::Application#new` takes a `Gio::ApplicationFlags` constants as input for your application, if your application would have special needs (those constants can be replaced by theirs respective symbol ie. `Gio::ApplicationFlags::NONE` == `:flags_none`). You must know that `GApplication` ignores arguments passed to `g_application_run()` on the Windows systems. It always uses command line arguments even when we pass an empty array to g_application_run().
+
+If you plan to create a cross-platform application, it is recommanded to use the `:handles_command_line` flags and the *command-line* signal. (reference : https://github.com/ruby-gnome2/ruby-gnome2/issues/721 ).
 
 Next we add instructions for the "activate" event of the `Gtk::Application` instance we created. The activate signal will be sent when your application is launched with the method `Gtk::Application#run` on the line below. This method also takes as arguments a ruby array of string. This allows GTK+ to parse specific command line arguments that control the behavior of GTK+ itself. The parsed arguments will be removed from the array, leaving the unrecognized ones for your application to parse.
 
@@ -516,7 +541,6 @@ stack.add_titled(scrolled, basename, basename)
 
 In this line, given that `self` is `ExampleAppWindow` the usage of `stack` is a call to the method we have created previously. So here we add a tab with a `Gtk::ScrolledWindow` in the `Gtk::Stack` widget of our template and we display the file content.
 
-
 ### An application menu
 https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.8
 
@@ -599,10 +623,10 @@ application.add_action(action)
 application.set_accels_for_action("app.quit", quit_accels)
 ```
 
-### A preferences dialog
+### A preference dialog
 https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.9
 
-### Define and store settings for an application with gschemas
+#### Define and store settings for an application with gschemas
 *    exampleapp5/exampleapp.rb
 
 A typical application will have a some preferences that should be remembered from one run to the next. Even for our simple example application, we may want to change the font that is used for the content.
@@ -824,7 +848,7 @@ def open(file)
 end
 ``` 
 
-## Adding a search bar
+### Adding a search bar
 https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.10
 
 *    exampleapp7/exampleapp.rb
@@ -934,5 +958,343 @@ In this part of code, the use of the method `set_connect_func` will allow us to
 
     <signal name="search-changed" handler="search_text_changed"/>
 
-Those pieces together mean that for the signal *search-changed* of the `Gtk::SearchEntry`, trigger the private method of `ExampleAppWindow` that is called `search_text_changed`.
+Those pieces together mean that the signal *search-changed* of the `Gtk::SearchEntry`, trigger the private method of `ExampleAppWindow` that is called `search_text_changed`.
+
+### Adding a sidebar
+https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.11
+
+*    exampleapp8/exampleapp.rb
+
+As another piece of functionality, we are adding a sidebar, which demonstrates `Gtk::MenuButton`, `Gtk::Revealer` and Gtk::ListBox`.
+
+window.ui :
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+  <!-- interface-requires gtk+ 3.8 -->
+  <template class="ExampleAppWindow" parent="GtkApplicationWindow">
+    <property name="title" translatable="yes">Example Application</property>
+    <property name="default-width">600</property>
+    <property name="default-height">400</property>
+    <child>
+      <object class="GtkBox" id="content_box">
+        <property name="visible">True</property>
+        <property name="orientation">vertical</property>
+        <child>
+          <object class="GtkHeaderBar" id="header">
+            <property name="visible">True</property>
+            <child type="title">
+              <object class="GtkStackSwitcher" id="tabs">
+                <property name="visible">True</property>
+                <property name="margin">6</property>
+                <property name="stack">stack</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkToggleButton" id="search">
+                <property name="visible">True</property>
+                <property name="sensitive">False</property>
+                <style>
+                  <class name="image-button"/>
+                </style>
+                <child>
+                  <object class="GtkImage" id="search-icon">
+                    <property name="visible">True</property>
+                    <property name="icon-name">edit-find-symbolic</property>
+                    <property name="icon-size">1</property>
+                  </object>
+                </child>
+              </object>
+              <packing>
+                <property name="pack-type">end</property>
+              </packing>
+            </child>
+            <child>
+              <object class="GtkMenuButton" id="gears">
+                <property name="visible">True</property>
+                <property name="direction">none</property>
+                <property name="use-popover">True</property>
+                <style>
+                  <class name="image-button"/>
+                </style>
+              </object>
+              <packing>
+                <property name="pack-type">end</property>
+              </packing>
+            </child>
+          </object>
+        </child>
+        <child>
+          <object class="GtkSearchBar" id="searchbar">
+            <property name="visible">True</property>
+            <child>
+              <object class="GtkSearchEntry" id="searchentry">
+                <signal name="search-changed" handler="search_text_changed"/>
+                <property name="visible">True</property>
+              </object>
+            </child>
+          </object>
+        </child>
+        <child>
+          <object class="GtkBox" id="hbox">
+            <property name="visible">True</property>
+            <child>
+              <object class="GtkRevealer" id="sidebar">
+                <property name="visible">True</property>
+                <property name="transition-type">slide-right</property>
+                <child>
+                 <object class="GtkScrolledWindow" id="sidebar-sw">
+                   <property name="visible">True</property>
+                   <property name="hscrollbar-policy">never</property>
+                   <property name="vscrollbar-policy">automatic</property>
+                   <child>
+                     <object class="GtkListBox" id="words">
+                       <property name="visible">True</property>
+                       <property name="selection-mode">none</property>
+                     </object>
+                   </child>
+                 </object>
+                </child>
+              </object>
+            </child>
+            <child>
+              <object class="GtkStack" id="stack">
+                <signal name="notify::visible-child" handler="visible_child_changed"/>
+                <property name="visible">True</property>
+              </object>
+            </child>
+          </object>
+        </child>
+      </object>
+    </child>
+  </template>
+</interface>
+```
+
+The code to populate the sidebar with buttons for the words found in each file is a little too involved to go into here. But we'll look at the code to add the gears menu.
+As expected by now, the gears menu is specified in a GtkBuilder ui file.
+
+gears-menu.ui
+
+```xml
+<?xml version="1.0"?>
+<interface>
+  <!-- interface-requires gtk+ 3.0 -->
+  <menu id="menu">
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_Words</attribute>
+        <attribute name="action">win.show-words</attribute>
+      </item>
+    </section>
+  </menu>
+</interface>
+```
+To connect the menuitem to the show-words setting, we use a `Gio::SimpleAction` corresponding to the given `Gio::Settings` key.
+
+```ruby
+class ExampleAppWindow < Gtk::ApplicationWindow
+  # some code
+  def initialize(application)
+    super(:application => application)
+    @settings = Gio::Settings.new("org.gtk.exampleapp")
+    @settings.bind("transition",
+                   stack,
+                   "transition-type",
+                   Gio::SettingsBindFlags::DEFAULT)
+    search.bind_property("active", searchbar, "search-mode-enabled", :bidirectional)
+    @settings.bind("show-words",
+                   sidebar,
+                   "reveal-child",
+                   Gio::SettingsBindFlags::DEFAULT)
+    sidebar.signal_connect "notify::reveal-child" do |_sidebar, _gparamspec|
+      update_words(self)
+    end
+    builder = Gtk::Builder.new(:resource => "/org/gtk/exampleapp/gears-menu.ui")
+    menu = builder.get_object("menu")
+    gears.set_menu_model(menu)
+    action = @settings.create_action("show-words")
+    add_action(action)
+  end
+
+  # some code
+end
+```
+
+### Properties
+
+https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.12
+
+Widgets and other objects have many useful properties.
+
+Here we show some ways to use them in new and flexible ways, by wrapping them in actions with `Gio::PropertyAction` or by binding them with `Gio::Binding`.
+To set this up, we add two labels to the header bar in our window template, named *lines_label* and *lines*, and bind them to struct members in the private struct, as we've seen a couple of times by now.
+We add a new "Lines" menu item to the gears menu, which triggers the show-lines action:
+
+```xml
+<?xml version="1.0"?>
+<interface>
+  <!-- interface-requires gtk+ 3.0 -->
+  <menu id="menu">
+    <section>
+      <item>
+        <attribute name="label" translatable="yes">_Words</attribute>
+        <attribute name="action">win.show-words</attribute>
+      </item>
+      <item>
+        <attribute name="label" translatable="yes">_Lines</attribute>
+        <attribute name="action">win.show-lines</attribute>
+      </item>
+    </section>
+  </menu>
+</interface>
+```
+
+To make this menu item do something, we create a property action for the visible property of the lines label, and add it to the actions of the window. The effect of this is that the visibility of the label gets toggled every time the action is activated.
+Since we want both labels to appear and disappear together, we bind the visible property of the lines_label widget to the same property of the lines widget.
+
+*    exampleapp9/exampleapp.rb
+
+```ruby
+# ...
+class ExampleAppWindow < Gtk::ApplicationWindow
+# ...
+  def initialize(application)
+    super(:application => application)
+# ...
+    action = Gio::PropertyAction.new("show-lines", lines, "visible")
+    add_action(action)
+    lines.bind_property("visible", lines_label, "visible", :default)
+  end
+```
+We also need a function that counts the lines of the currently active tab, and updates the lines label. See the full source if you are interested in the details.
+
+### Header Bar
+
+https://developer.gnome.org/gtk3/stable/ch01s04.html#id-1.2.3.12.13
+
+Our application already uses a `Gtk::HeaderBar`, but so far it still gets a 'normal' window titlebar on top of that. This is a bit redundant, and we will now tell GTK+ to use the header bar as replacement for the titlebar. To do so, we move it around to be a direct child of the window, and set its type to be titlebar.
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+  <!-- interface-requires gtk+ 3.8 -->
+  <template class="ExampleAppWindow" parent="GtkApplicationWindow">
+    <property name="title" translatable="yes">Example Application</property>
+    <property name="default-width">600</property>
+    <property name="default-height">400</property>
+        <child type="titlebar">
+          <object class="GtkHeaderBar" id="header">
+            <property name="visible">True</property>
+            <property name="show-close-button">True</property>
+            <child>
+              <object class="GtkLabel" id="lines_label">
+                <property name="visible">False</property>
+                <property name="label" translatable="yes">Lines:</property>
+              </object>
+              <packing>
+                <property name="pack-type">start</property>
+              </packing>
+            </child>
+            <child>
+              <object class="GtkLabel" id="lines">
+                <property name="visible">False</property>
+              </object>
+              <packing>
+                <property name="pack-type">start</property>
+              </packing>
+            </child>
+            <child type="title">
+              <object class="GtkStackSwitcher" id="tabs">
+                <property name="visible">True</property>
+                <property name="margin">6</property>
+                <property name="stack">stack</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkToggleButton" id="search">
+                <property name="visible">True</property>
+                <property name="sensitive">False</property>
+                <style>
+                  <class name="image-button"/>
+                </style>
+                <child>
+                  <object class="GtkImage" id="search-icon">
+                    <property name="visible">True</property>
+                    <property name="icon-name">edit-find-symbolic</property>
+                    <property name="icon-size">1</property>
+                  </object>
+                </child>
+              </object>
+              <packing>
+                <property name="pack-type">end</property>
+              </packing>
+            </child>
+            <child>
+              <object class="GtkMenuButton" id="gears">
+                <property name="visible">True</property>
+                <property name="direction">none</property>
+                <property name="use-popover">True</property>
+                <style>
+                  <class name="image-button"/>
+                </style>
+              </object>
+              <packing>
+                <property name="pack-type">end</property>
+              </packing>
+            </child>
+          </object>
+        </child>
+    <child>
+      <object class="GtkBox" id="content_box">
+        <property name="visible">True</property>
+        <property name="orientation">vertical</property>
+        <child>
+          <object class="GtkSearchBar" id="searchbar">
+            <property name="visible">True</property>
+            <child>
+              <object class="GtkSearchEntry" id="searchentry">
+                <signal name="search-changed" handler="search_text_changed"/>
+                <property name="visible">True</property>
+              </object>
+            </child>
+          </object>
+        </child>
+        <child>
+          <object class="GtkBox" id="hbox">
+            <property name="visible">True</property>
+            <child>
+              <object class="GtkRevealer" id="sidebar">
+                <property name="visible">True</property>
+                <property name="transition-type">slide-right</property>
+                <child>
+                 <object class="GtkScrolledWindow" id="sidebar-sw">
+                   <property name="visible">True</property>
+                   <property name="hscrollbar-policy">never</property>
+                   <property name="vscrollbar-policy">automatic</property>
+                   <child>
+                     <object class="GtkListBox" id="words">
+                       <property name="visible">True</property>
+                       <property name="selection-mode">none</property>
+                     </object>
+                   </child>
+                 </object>
+                </child>
+              </object>
+            </child>
+            <child>
+              <object class="GtkStack" id="stack">
+                <signal name="notify::visible-child" handler="visible_child_changed"/>
+                <property name="visible">True</property>
+              </object>
+            </child>
+          </object>
+        </child>
+      </object>
+    </child>
+  </template>
+</interface>
+```
 
+A small extra bonus of using a header bar is that we get a fallback application menu for free.