• 一个应用菜单

    一个应用菜单

    就像窗口模板，在一个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