填充窗口

在这节中，我们用GtkBuilder 模板结合一个GtkBuilder ui 文件和我们的应用程序窗口类。

我们简单的ui 文件把GtkHeaderBar 放在GtkStack 部件顶端。头栏包括一个显示GtkStack 页面分页的一行的独立部件——GtkStackSwitcher。

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <interface>
  3.   <!-- interface-requires gtk+ 3.8 -->
  4.   <template class="ExampleAppWindow" parent="GtkApplicationWindow">
  5.     <property name="title" translatable="yes">Example Application</property>
  6.     <property name="default-width">600</property>
  7.     <property name="default-height">400</property>
  8.     <child>
  9.       <object class="GtkBox" id="content_box">
  10.         <property name="visible">True</property>
  11.         <property name="orientation">vertical</property>
  12.         <child>
  13.           <object class="GtkHeaderBar" id="header">
  14.             <property name="visible">True</property>
  15.             <child type="title">
  16.               <object class="GtkStackSwitcher" id="tabs">
  17.                 <property name="visible">True</property>
  18.                 <property name="margin">6</property>
  19.                 <property name="stack">stack</property>
  20.               </object>
  21.             </child>
  22.           </object>
  23.         </child>
  24.         <child>
  25.           <object class="GtkStack" id="stack">
  26.             <property name="visible">True</property>
  27.           </object>
  28.         </child>
  29.       </object>
  30.     </child>
  31.   </template>
  32. </interface>

为了在我们的应用程序中使用这个文件，我们回到我们的GtkApplicationWindow 子类，从类初始化函数中调用gtk_widget_class_set_template_from_resource() 来把ui 文件设为这个类的模板。在实例初始化函数中我们增加gtk_widget_init_template() 去为我们的类的个体实例化模板。

  1.  ...
  3. static void
  4. example_app_window_init (ExampleAppWindow *win)
  5. {
  6.   gtk_widget_init_template (GTK_WIDGET (win));
  7. }
  9. static void
  10. example_app_window_class_init (ExampleAppWindowClass *class)
  11. {
  12.   gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
  13.                                                "/org/gtk/exampleapp/window.ui");
  14. }
  16.  ...

(full source)

你也许注意到了，我们在函数中用了变量_from_resource()来设定一个模板。现在我们需要用GLib的资源功能在二进制文件中包含一个ui file。通常是在.gresource.xml中列出所有资源，就像这样：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <gresources>
  3.   <gresource prefix="/org/gtk/exampleapp">
  4.     <file preprocess="xml-stripblanks">window.ui</file>
  5.   </gresource>
  6. </gresources>

这个文件必须被转换成一个C 源文件，这样它才能和其他源文件一起被编译链接进应用程序中。因此，我们使用了glib-complie-resources：

  1. glib-compile-resources exampleapp.gresource.xml --target=resources.c --generate-source

如今我们的应用程序就像这样：

getting-started-app2.png