一个应用菜单

就像窗口模板，在一个ui file 中我们指定了我们的应用程序菜单，然后作为资源向二进制文件中添加。

  1. <?xml version="1.0"?>
  2. <interface>
  3.   <!-- interface-requires gtk+ 3.0 -->
  4.   <menu id="appmenu">
  5.     <section>
  6.       <item>
  7.         <attribute name="label" translatable="yes">_Preferences</attribute>
  8.         <attribute name="action">app.preferences</attribute>
  9.       </item>
  10.     </section>
  11.     <section>
  12.       <item>
  13.         <attribute name="label" translatable="yes">_Quit</attribute>
  14.         <attribute name="action">app.quit</attribute>
  15.       </item>
  16.     </section>
  17.   </menu>
  18. </interface>

为了关联应用程序和应用菜单，我们必须调用gtk_application_set_app_menu()。y因为应用菜单被活动的GActions激活，所以必须为应用程序增加一个合适的设定。

所有这些任务最好在startup()函数中做完，因为startup()函数被保证在每个应用程序实例中只被调用一次。

  1. ...
  3. static void
  4. preferences_activated (GSimpleAction *action,
  5.                        GVariant      *parameter,
  6.                        gpointer       app)
  7. {
  8. }
  10. static void
  11. quit_activated (GSimpleAction *action,
  12.                 GVariant      *parameter,
  13.                 gpointer       app)
  14. {
  15.   g_application_quit (G_APPLICATION (app));
  16. }
  18. static GActionEntry app_entries[] =
  19. {
  20.   { "preferences", preferences_activated, NULL, NULL, NULL },
  21.   { "quit", quit_activated, NULL, NULL, NULL }
  22. };
  24. static void
  25. example_app_startup (GApplication *app)
  26. {
  27.   GtkBuilder *builder;
  28.   GMenuModel *app_menu;
  29.   const gchar *quit_accels[2] = { "<Ctrl>Q", NULL };
  31.   G_APPLICATION_CLASS (example_app_parent_class)->startup (app);
  33.   g_action_map_add_action_entries (G_ACTION_MAP (app),
  34.                                    app_entries, G_N_ELEMENTS (app_entries),
  35.                                    app);
  36.   gtk_application_set_accels_for_action (GTK_APPLICATION (app),
  37.                                          "app.quit",
  38.                                          quit_accels);
  40.   builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
  41.   app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
  42.   gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
  43.   g_object_unref (builder);
  44. }
  46. static void
  47. example_app_class_init (ExampleAppClass *class)
  48. {
  49.   G_APPLICATION_CLASS (class)->startup = example_app_startup;
  50.   ...
  51. }
  53. ...

(full source)

菜单首选项如今并不能作任何事，但是Quit菜单选项的功能是正常的。注意它也可以被快捷键Ctrl-Q激活。这个快捷方式已经在gtk_application_set_accels_for_action()中被添加。

我们的应用菜单如下：

getting-started-app4.png