GTK application menu & menubar

builder = gtk_builder_new ();
  gtk_builder_add_from_resource (builder, "/org/gtk/exampleapp/app-menu.ui", NULL);
  appmenu = (GMenuModel *)gtk_builder_get_object (builder, "appmenu");
  //appmenu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
  menubar = (GMenuModel *)gtk_builder_get_object (builder, "menubar");
  //以下两个Api并无明确区分， 可以合并成一个菜单。
  gtk_application_set_app_menu (GTK_APPLICATION (app), appmenu); //设置应用菜单。 用于多个应用的操作。 如打开一个新应用。
  gtk_application_set_menubar (GTK_APPLICATION (app), menubar); //设置窗口菜单。应用内的菜单。

  g_object_unref (builder)

系统/应用菜单采用的格式不能使用glade完成， 他拥有自己的格式（GMenuModel）， 只能自己通过 XML 编写。
GMenuModel 规则 https://developer.gnome.org/gio/stable/GMenuModel.html 

The 'standard' attributes and link types have predefined names: G_MENU_ATTRIBUTE_LABEL, G_MENU_ATTRIBUTE_ACTION, G_MENU_ATTRIBUTE_TARGET, G_MENU_LINK_SECTION and G_MENU_LINK_SUBMENU.
标准属性包含该 label action target section submenu
action 分为两个动作组 action group， 对于应用级的使用 app.xxx 对于窗口的使用 win.xxx
action 分为
    1.无参数无返回
    2.无参数 boolean返回， 定义菜单时需要使用 toggle 或者 switch， 如复选框等菜单
    3.string参数， string返回。如单选 radio menu items 框等菜单。

各个action --> app.xxx。 所有的xxx 应当被映射为 GActionEntry 数组。通过

struct GActionEntry {
  const gchar *name;  ---》                              //映射的 xxx 名字
  void (* activate) (GSimpleAction *action,     --》     //处理函数
                     GVariant      *parameter,
                     gpointer       user_data);

  const gchar *parameter_type;                           //传入 activate 的参数类型。
  const gchar *state;                                    //初始状态值。
  void (* change_state) (GSimpleAction *action,          //activate 执行完毕后的回调
                         GVariant      *value,
                         gpointer       user_data);
};
static GActionEntry app_entries[] = {
  { "new", activate_new, NULL, NULL, NULL },
  { "open", activate_open, NULL, NULL, NULL },
  { "save", activate_action, NULL, NULL, NULL },
  { "save-as", activate_action, NULL, NULL, NULL },
  { "quit", activate_quit, NULL, NULL, NULL },
  { "dark", activate_toggle, NULL, "false", change_theme_state }
}

数组通过调用 g_action_map_add_action_entries (G_ACTION_MAP (app), app_entries, G_N_ELEMENTS (app_entries), app); 实现映射。根据参数的不同，GTK会自动判断菜单的类型（普通，checkbox/radioGroup等等）

而对应的 win.xxx 

static GActionEntry win_entries[] = {
  { "titlebar", activate_toggle, NULL, "false", change_titlebar_state },
  { "shape", activate_radio, "s", "'oval'", change_radio_state },
  { "bold", activate_toggle, NULL, "false", NULL },
  { "about", activate_about, NULL, NULL, NULL },
  { "file1", activate_action, NULL, NULL, NULL },
  { "logo", activate_action, NULL, NULL, NULL }
};

 通过 g_action_map_add_action_entries (G_ACTION_MAP (window),  win_entries, G_N_ELEMENTS (win_entries),  window); 加载给不同的窗口

<?xml version="1.0"?>
<interface>
  <menu id="menubar">
    <section>
     <item>   应用菜单 永远显示在第一列  &lt; &gt;用于反义 <>
          <attribute name="label" translatable="yes">_New</attribute>      显示 New
          <attribute name="action">app.new</attribute>                     调用应用的 new 指令
          <attribute name="accel">&lt;Primary&gt;n</attribute>             快捷键
     </item>
     <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>
          <attribute name="accel">&lt;Primary&gt;s</attribute>
     </item>
     <item>
         <attribute name="label" translatable="yes">Save _As...</attribute>
         <attribute name="action">app.save-as</attribute>
         <attribute name="accel">&lt;Primary&gt;s</attribute>
     </item>
   </section>
   <section>
     <item>  也是应用菜单 也是显示在第一列， 分成多个 section定义会产生一个分隔符而已
         <attribute name="label" translatable="yes">_Quit</attribute>
         <attribute name="action">app.quit</attribute>
         <attribute name="accel">&lt;Primary&gt;q</attribute>
     </item>
   </section>

   


     //定义窗口级菜单， action 大部分用 win. 但是也可以用 app. 打头

    <submenu>
      <attribute name="label" translatable="yes">_Preferences</attribute>  显示为一个下拉菜单
      <section>
        <item>
          <attribute name="label" translatable="yes">_Prefer Dark Theme</attribute> 显示为一个 checkbox 菜单
          <attribute name="action">app.dark</attribute>
        </item>
        <item>
          <attribute name="label" translatable="yes">_Hide Titlebar when maximized</attribute>显示为一个 checkbox 菜单
          <attribute name="action">win.titlebar</attribute>
        </item>
        <submenu>
          <attribute name="label" translatable="yes">_Color</attribute>
          <section>
            <item>
              <attribute name="label" translatable="yes">_Red</attribute> 显示为一个 radio box 菜单
              <attribute name="action">app.color</attribute>
              <attribute name="target">red</attribute>
              <attribute name="accel">&lt;Primary&gt;r</attribute>
            </item>
            <item>
              <attribute name="label" translatable="yes">_Green</attribute>显示为一个 radio box 菜单
              <attribute name="action">app.color</attribute>
              <attribute name="target">green</attribute>
              <attribute name="accel">&lt;Primary&gt;g</attribute>
            </item>
            <item>
              <attribute name="label" translatable="yes">_Blue</attribute>显示为一个 radio box 菜单
              <attribute name="action">app.color</attribute>
              <attribute name="target">blue</attribute>
              <attribute name="accel">&lt;Primary&gt;b</attribute>
            </item>
          </section>
        </submenu>
        <submenu>
          <attribute name="label" translatable="yes">_Shape</attribute>
          <section>
            <item>
              <attribute name="label" translatable="yes">_Square</attribute> 显示为一个 radio box 菜单
              <attribute name="action">win.shape</attribute>
              <attribute name="target">square</attribute>
              <attribute name="accel">&lt;Primary&gt;s</attribute>