docs/reference/gio/html/GMenu.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GMenu</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="application.html" title="Application support">
   9 <link rel="prev" href="GMenuModel.html" title="GMenuModel">
  10 <link rel="next" href="gio-GMenuModel-exporter.html" title="GMenuModel exporter">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="GMenuModel.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="application.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GIO Reference Manual</th>
  21 <td><a accesskey="n" href="gio-GMenuModel-exporter.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GMenu.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GMenu.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GMenu.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29 </td></tr>
  30 </table>
  31 <div class="refentry">
  32 <a name="GMenu"></a><div class="titlepage"></div>
  33 <div class="refnamediv"><table width="100%"><tr>
  34 <td valign="top">
  35 <h2><span class="refentrytitle"><a name="GMenu.top_of_page"></a>GMenu</span></h2>
  36 <p>GMenu — A simple implementation of GMenuModel</p>
  37 </td>
  38 <td valign="top" align="right"></td>
  39 </tr></table></div>
  40 <div class="refsynopsisdiv">
  41 <a name="GMenu.synopsis"></a><h2>Synopsis</h2>
  42 <a name="GMenuItem"></a><pre class="synopsis">                    <a class="link" href="GMenu.html#GMenu-struct" title="GMenu">GMenu</a>;
  43 <a class="link" href="GMenu.html" title="GMenu"><span class="returnvalue">GMenu</span></a> *             <a class="link" href="GMenu.html#g-menu-new" title="g_menu_new ()">g_menu_new</a>                          (<em class="parameter"><code><span class="type">void</span></code></em>);
  44 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-freeze" title="g_menu_freeze ()">g_menu_freeze</a>                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>);
  45
  46 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-insert" title="g_menu_insert ()">g_menu_insert</a>                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  47                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
  48                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  49                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);
  50 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-prepend" title="g_menu_prepend ()">g_menu_prepend</a>                      (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  51                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  52                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);
  53 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-append" title="g_menu_append ()">g_menu_append</a>                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  54                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  55                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);
  56
  57 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()">g_menu_insert_item</a>                  (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  58                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
  59                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);
  60 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-append-item" title="g_menu_append_item ()">g_menu_append_item</a>                  (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  61                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);
  62 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-prepend-item" title="g_menu_prepend_item ()">g_menu_prepend_item</a>                 (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  63                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);
  64
  65 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-insert-section" title="g_menu_insert_section ()">g_menu_insert_section</a>               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  66                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
  67                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  68                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);
  69 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-prepend-section" title="g_menu_prepend_section ()">g_menu_prepend_section</a>              (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  70                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  71                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);
  72 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-append-section" title="g_menu_append_section ()">g_menu_append_section</a>               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  73                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  74                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);
  75
  76 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-append-submenu" title="g_menu_append_submenu ()">g_menu_append_submenu</a>               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  77                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  78                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);
  79 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-insert-submenu" title="g_menu_insert_submenu ()">g_menu_insert_submenu</a>               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  80                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
  81                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  82                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);
  83 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-prepend-submenu" title="g_menu_prepend_submenu ()">g_menu_prepend_submenu</a>              (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  84                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  85                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);
  86
  87 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-remove" title="g_menu_remove ()">g_menu_remove</a>                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
  88                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
  89
  90                     <a class="link" href="GMenu.html#GMenuItem-struct" title="GMenuItem">GMenuItem</a>;
  91 <a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         <a class="link" href="GMenu.html#g-menu-item-new" title="g_menu_item_new ()">g_menu_item_new</a>                     (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  92                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);
  93 <a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         <a class="link" href="GMenu.html#g-menu-item-new-section" title="g_menu_item_new_section ()">g_menu_item_new_section</a>             (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  94                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);
  95 <a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         <a class="link" href="GMenu.html#g-menu-item-new-submenu" title="g_menu_item_new_submenu ()">g_menu_item_new_submenu</a>             (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
  96                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);
  97
  98 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-label" title="g_menu_item_set_label ()">g_menu_item_set_label</a>               (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
  99                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 100 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-action-and-target-value" title="g_menu_item_set_action_and_target_value ()">g_menu_item_set_action_and_target_value</a>
 101                                                         (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 102                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action</code></em>,
 103                                                          <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *target_value</code></em>);
 104 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-action-and-target" title="g_menu_item_set_action_and_target ()">g_menu_item_set_action_and_target</a>   (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 105                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action</code></em>,
 106                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format_string</code></em>,
 107                                                          <em class="parameter"><code>...</code></em>);
 108 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-detailed-action" title="g_menu_item_set_detailed_action ()">g_menu_item_set_detailed_action</a>     (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 109                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);
 110 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-section" title="g_menu_item_set_section ()">g_menu_item_set_section</a>             (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 111                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);
 112 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-submenu" title="g_menu_item_set_submenu ()">g_menu_item_set_submenu</a>             (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 113                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);
 114
 115 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-attribute-value" title="g_menu_item_set_attribute_value ()">g_menu_item_set_attribute_value</a>     (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 116                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
 117                                                          <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);
 118 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-attribute" title="g_menu_item_set_attribute ()">g_menu_item_set_attribute</a>           (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 119                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
 120                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format_string</code></em>,
 121                                                          <em class="parameter"><code>...</code></em>);
 122 <span class="returnvalue">void</span>                <a class="link" href="GMenu.html#g-menu-item-set-link" title="g_menu_item_set_link ()">g_menu_item_set_link</a>                (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 123                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *link</code></em>,
 124                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *model</code></em>);
 125 </pre>
 126 </div>
 127 <div class="refsect1">
 128 <a name="GMenu.object-hierarchy"></a><h2>Object Hierarchy</h2>
 129 <pre class="synopsis">
 130   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 131    +----<a class="link" href="GMenuModel.html" title="GMenuModel">GMenuModel</a>
 132          +----GMenu
 133 </pre>
 134 <pre class="synopsis">
 135   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 136    +----GMenuItem
 137 </pre>
 138 </div>
 139 <div class="refsect1">
 140 <a name="GMenu.description"></a><h2>Description</h2>
 141 <p>
 142 <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> is a simple implementation of <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a>.
 143 You populate a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> by adding <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> instances to it.
 144 </p>
 145 <p>
 146 There are some convenience functions to allow you to directly
 147 add items (avoiding <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>) for the common cases. To add
 148 a regular item, use <a class="link" href="GMenu.html#g-menu-insert" title="g_menu_insert ()"><code class="function">g_menu_insert()</code></a>. To add a section, use
 149 <a class="link" href="GMenu.html#g-menu-insert-section" title="g_menu_insert_section ()"><code class="function">g_menu_insert_section()</code></a>. To add a submenu, use
 150 <a class="link" href="GMenu.html#g-menu-insert-submenu" title="g_menu_insert_submenu ()"><code class="function">g_menu_insert_submenu()</code></a>.
 151 </p>
 152 </div>
 153 <div class="refsect1">
 154 <a name="GMenu.details"></a><h2>Details</h2>
 155 <div class="refsect2">
 156 <a name="GMenu-struct"></a><h3>GMenu</h3>
 157 <pre class="programlisting">typedef struct _GMenu GMenu;</pre>
 158 <p>
 159 <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> is an opaque structure type.  You must access it using the
 160 functions below.
 161 </p>
 162 <p class="since">Since 2.32</p>
 163 </div>
 164 <hr>
 165 <div class="refsect2">
 166 <a name="g-menu-new"></a><h3>g_menu_new ()</h3>
 167 <pre class="programlisting"><a class="link" href="GMenu.html" title="GMenu"><span class="returnvalue">GMenu</span></a> *             g_menu_new                          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 168 <p>
 169 Creates a new <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>.
 170 </p>
 171 <p>
 172 The new menu has no items.
 173 </p>
 174 <div class="variablelist"><table border="0">
 175 <col align="left" valign="top">
 176 <tbody><tr>
 177 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 178 <td>a new <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 179 </td>
 180 </tr></tbody>
 181 </table></div>
 182 <p class="since">Since 2.32</p>
 183 </div>
 184 <hr>
 185 <div class="refsect2">
 186 <a name="g-menu-freeze"></a><h3>g_menu_freeze ()</h3>
 187 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_freeze                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>);</pre>
 188 <p>
 189 Marks <em class="parameter"><code>menu</code></em> as frozen.
 190 </p>
 191 <p>
 192 After the menu is frozen, it is an error to attempt to make any
 193 changes to it.  In effect this means that the <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> API must no
 194 longer be used.
 195 </p>
 196 <p>
 197 This function causes <a class="link" href="GMenuModel.html#g-menu-model-is-mutable" title="g_menu_model_is_mutable ()"><code class="function">g_menu_model_is_mutable()</code></a> to begin returning
 198 <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, which has some positive performance implications.
 199 </p>
 200 <div class="variablelist"><table border="0">
 201 <col align="left" valign="top">
 202 <tbody><tr>
 203 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 204 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 205 </td>
 206 </tr></tbody>
 207 </table></div>
 208 <p class="since">Since 2.32</p>
 209 </div>
 210 <hr>
 211 <div class="refsect2">
 212 <a name="g-menu-insert"></a><h3>g_menu_insert ()</h3>
 213 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_insert                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 214                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
 215                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 216                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);</pre>
 217 <p>
 218 Convenience function for inserting a normal menu item into <em class="parameter"><code>menu</code></em>.
 219 Combine <a class="link" href="GMenu.html#g-menu-new" title="g_menu_new ()"><code class="function">g_menu_new()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a more flexible
 220 alternative.
 221 </p>
 222 <div class="variablelist"><table border="0">
 223 <col align="left" valign="top">
 224 <tbody>
 225 <tr>
 226 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 227 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 228 </td>
 229 </tr>
 230 <tr>
 231 <td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
 232 <td>the position at which to insert the item</td>
 233 </tr>
 234 <tr>
 235 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 236 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 237 </td>
 238 </tr>
 239 <tr>
 240 <td><p><span class="term"><em class="parameter"><code>detailed_action</code></em> :</span></p></td>
 241 <td>the detailed action string, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 242 </td>
 243 </tr>
 244 </tbody>
 245 </table></div>
 246 <p class="since">Since 2.32</p>
 247 </div>
 248 <hr>
 249 <div class="refsect2">
 250 <a name="g-menu-prepend"></a><h3>g_menu_prepend ()</h3>
 251 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_prepend                      (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 252                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 253                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);</pre>
 254 <p>
 255 Convenience function for prepending a normal menu item to the start
 256 of <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-new" title="g_menu_new ()"><code class="function">g_menu_new()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a more
 257 flexible alternative.
 258 </p>
 259 <div class="variablelist"><table border="0">
 260 <col align="left" valign="top">
 261 <tbody>
 262 <tr>
 263 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 264 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 265 </td>
 266 </tr>
 267 <tr>
 268 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 269 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 270 </td>
 271 </tr>
 272 <tr>
 273 <td><p><span class="term"><em class="parameter"><code>detailed_action</code></em> :</span></p></td>
 274 <td>the detailed action string, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 275 </td>
 276 </tr>
 277 </tbody>
 278 </table></div>
 279 <p class="since">Since 2.32</p>
 280 </div>
 281 <hr>
 282 <div class="refsect2">
 283 <a name="g-menu-append"></a><h3>g_menu_append ()</h3>
 284 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_append                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 285                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 286                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);</pre>
 287 <p>
 288 Convenience function for appending a normal menu item to the end of
 289 <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-new" title="g_menu_new ()"><code class="function">g_menu_new()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a more
 290 flexible alternative.
 291 </p>
 292 <div class="variablelist"><table border="0">
 293 <col align="left" valign="top">
 294 <tbody>
 295 <tr>
 296 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 297 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 298 </td>
 299 </tr>
 300 <tr>
 301 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 302 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 303 </td>
 304 </tr>
 305 <tr>
 306 <td><p><span class="term"><em class="parameter"><code>detailed_action</code></em> :</span></p></td>
 307 <td>the detailed action string, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 308 </td>
 309 </tr>
 310 </tbody>
 311 </table></div>
 312 <p class="since">Since 2.32</p>
 313 </div>
 314 <hr>
 315 <div class="refsect2">
 316 <a name="g-menu-insert-item"></a><h3>g_menu_insert_item ()</h3>
 317 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_insert_item                  (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 318                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
 319                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);</pre>
 320 <p>
 321 Inserts <em class="parameter"><code>item</code></em> into <em class="parameter"><code>menu</code></em>.
 322 </p>
 323 <p>
 324 The "insertion" is actually done by copying all of the attribute and
 325 link values of <em class="parameter"><code>item</code></em> and using them to form a new item within <em class="parameter"><code>menu</code></em>.
 326 As such, <em class="parameter"><code>item</code></em> itself is not really inserted, but rather, a menu item
 327 that is exactly the same as the one presently described by <em class="parameter"><code>item</code></em>.
 328 </p>
 329 <p>
 330 This means that <em class="parameter"><code>item</code></em> is essentially useless after the insertion
 331 occurs.  Any changes you make to it are ignored unless it is inserted
 332 again (at which point its updated values will be copied).
 333 </p>
 334 <p>
 335 You should probably just free <em class="parameter"><code>item</code></em> once you're done.
 336 </p>
 337 <p>
 338 There are many convenience functions to take care of common cases.
 339 See <a class="link" href="GMenu.html#g-menu-insert" title="g_menu_insert ()"><code class="function">g_menu_insert()</code></a>, <a class="link" href="GMenu.html#g-menu-insert-section" title="g_menu_insert_section ()"><code class="function">g_menu_insert_section()</code></a> and
 340 <a class="link" href="GMenu.html#g-menu-insert-submenu" title="g_menu_insert_submenu ()"><code class="function">g_menu_insert_submenu()</code></a> as well as "prepend" and "append" variants of
 341 each of these functions.
 342 </p>
 343 <div class="variablelist"><table border="0">
 344 <col align="left" valign="top">
 345 <tbody>
 346 <tr>
 347 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 348 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 349 </td>
 350 </tr>
 351 <tr>
 352 <td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
 353 <td>the position at which to insert the item</td>
 354 </tr>
 355 <tr>
 356 <td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
 357 <td>the <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> to insert</td>
 358 </tr>
 359 </tbody>
 360 </table></div>
 361 <p class="since">Since 2.32</p>
 362 </div>
 363 <hr>
 364 <div class="refsect2">
 365 <a name="g-menu-append-item"></a><h3>g_menu_append_item ()</h3>
 366 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_append_item                  (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 367                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);</pre>
 368 <p>
 369 Appends <em class="parameter"><code>item</code></em> to the end of <em class="parameter"><code>menu</code></em>.
 370 </p>
 371 <p>
 372 See <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for more information.
 373 </p>
 374 <div class="variablelist"><table border="0">
 375 <col align="left" valign="top">
 376 <tbody>
 377 <tr>
 378 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 379 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 380 </td>
 381 </tr>
 382 <tr>
 383 <td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
 384 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> to append</td>
 385 </tr>
 386 </tbody>
 387 </table></div>
 388 <p class="since">Since 2.32</p>
 389 </div>
 390 <hr>
 391 <div class="refsect2">
 392 <a name="g-menu-prepend-item"></a><h3>g_menu_prepend_item ()</h3>
 393 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_prepend_item                 (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 394                                                          <em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *item</code></em>);</pre>
 395 <p>
 396 Prepends <em class="parameter"><code>item</code></em> to the start of <em class="parameter"><code>menu</code></em>.
 397 </p>
 398 <p>
 399 See <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for more information.
 400 </p>
 401 <div class="variablelist"><table border="0">
 402 <col align="left" valign="top">
 403 <tbody>
 404 <tr>
 405 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 406 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 407 </td>
 408 </tr>
 409 <tr>
 410 <td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
 411 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> to prepend</td>
 412 </tr>
 413 </tbody>
 414 </table></div>
 415 <p class="since">Since 2.32</p>
 416 </div>
 417 <hr>
 418 <div class="refsect2">
 419 <a name="g-menu-insert-section"></a><h3>g_menu_insert_section ()</h3>
 420 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_insert_section               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 421                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
 422                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 423                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);</pre>
 424 <p>
 425 Convenience function for inserting a section menu item into <em class="parameter"><code>menu</code></em>.
 426 Combine <a class="link" href="GMenu.html#g-menu-item-new-section" title="g_menu_item_new_section ()"><code class="function">g_menu_item_new_section()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a more
 427 flexible alternative.
 428 </p>
 429 <div class="variablelist"><table border="0">
 430 <col align="left" valign="top">
 431 <tbody>
 432 <tr>
 433 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 434 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 435 </td>
 436 </tr>
 437 <tr>
 438 <td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
 439 <td>the position at which to insert the item</td>
 440 </tr>
 441 <tr>
 442 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 443 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 444 </td>
 445 </tr>
 446 <tr>
 447 <td><p><span class="term"><em class="parameter"><code>section</code></em> :</span></p></td>
 448 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the section</td>
 449 </tr>
 450 </tbody>
 451 </table></div>
 452 <p class="since">Since 2.32</p>
 453 </div>
 454 <hr>
 455 <div class="refsect2">
 456 <a name="g-menu-prepend-section"></a><h3>g_menu_prepend_section ()</h3>
 457 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_prepend_section              (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 458                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 459                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);</pre>
 460 <p>
 461 Convenience function for prepending a section menu item to the start
 462 of <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-item-new-section" title="g_menu_item_new_section ()"><code class="function">g_menu_item_new_section()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for
 463 a more flexible alternative.
 464 </p>
 465 <div class="variablelist"><table border="0">
 466 <col align="left" valign="top">
 467 <tbody>
 468 <tr>
 469 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 470 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 471 </td>
 472 </tr>
 473 <tr>
 474 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 475 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 476 </td>
 477 </tr>
 478 <tr>
 479 <td><p><span class="term"><em class="parameter"><code>section</code></em> :</span></p></td>
 480 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the section</td>
 481 </tr>
 482 </tbody>
 483 </table></div>
 484 <p class="since">Since 2.32</p>
 485 </div>
 486 <hr>
 487 <div class="refsect2">
 488 <a name="g-menu-append-section"></a><h3>g_menu_append_section ()</h3>
 489 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_append_section               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 490                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 491                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);</pre>
 492 <p>
 493 Convenience function for appending a section menu item to the end of
 494 <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-item-new-section" title="g_menu_item_new_section ()"><code class="function">g_menu_item_new_section()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a
 495 more flexible alternative.
 496 </p>
 497 <div class="variablelist"><table border="0">
 498 <col align="left" valign="top">
 499 <tbody>
 500 <tr>
 501 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 502 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 503 </td>
 504 </tr>
 505 <tr>
 506 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 507 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 508 </td>
 509 </tr>
 510 <tr>
 511 <td><p><span class="term"><em class="parameter"><code>section</code></em> :</span></p></td>
 512 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the section</td>
 513 </tr>
 514 </tbody>
 515 </table></div>
 516 <p class="since">Since 2.32</p>
 517 </div>
 518 <hr>
 519 <div class="refsect2">
 520 <a name="g-menu-append-submenu"></a><h3>g_menu_append_submenu ()</h3>
 521 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_append_submenu               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 522                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 523                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);</pre>
 524 <p>
 525 Convenience function for appending a submenu menu item to the end of
 526 <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-item-new-submenu" title="g_menu_item_new_submenu ()"><code class="function">g_menu_item_new_submenu()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a
 527 more flexible alternative.
 528 </p>
 529 <div class="variablelist"><table border="0">
 530 <col align="left" valign="top">
 531 <tbody>
 532 <tr>
 533 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 534 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 535 </td>
 536 </tr>
 537 <tr>
 538 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 539 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 540 </td>
 541 </tr>
 542 <tr>
 543 <td><p><span class="term"><em class="parameter"><code>submenu</code></em> :</span></p></td>
 544 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the submenu</td>
 545 </tr>
 546 </tbody>
 547 </table></div>
 548 <p class="since">Since 2.32</p>
 549 </div>
 550 <hr>
 551 <div class="refsect2">
 552 <a name="g-menu-insert-submenu"></a><h3>g_menu_insert_submenu ()</h3>
 553 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_insert_submenu               (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 554                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
 555                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 556                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);</pre>
 557 <p>
 558 Convenience function for inserting a submenu menu item into <em class="parameter"><code>menu</code></em>.
 559 Combine <a class="link" href="GMenu.html#g-menu-item-new-submenu" title="g_menu_item_new_submenu ()"><code class="function">g_menu_item_new_submenu()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for a more
 560 flexible alternative.
 561 </p>
 562 <div class="variablelist"><table border="0">
 563 <col align="left" valign="top">
 564 <tbody>
 565 <tr>
 566 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 567 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 568 </td>
 569 </tr>
 570 <tr>
 571 <td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
 572 <td>the position at which to insert the item</td>
 573 </tr>
 574 <tr>
 575 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 576 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 577 </td>
 578 </tr>
 579 <tr>
 580 <td><p><span class="term"><em class="parameter"><code>submenu</code></em> :</span></p></td>
 581 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the submenu</td>
 582 </tr>
 583 </tbody>
 584 </table></div>
 585 <p class="since">Since 2.32</p>
 586 </div>
 587 <hr>
 588 <div class="refsect2">
 589 <a name="g-menu-prepend-submenu"></a><h3>g_menu_prepend_submenu ()</h3>
 590 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_prepend_submenu              (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 591                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 592                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);</pre>
 593 <p>
 594 Convenience function for prepending a submenu menu item to the start
 595 of <em class="parameter"><code>menu</code></em>.  Combine <a class="link" href="GMenu.html#g-menu-item-new-submenu" title="g_menu_item_new_submenu ()"><code class="function">g_menu_item_new_submenu()</code></a> and <a class="link" href="GMenu.html#g-menu-insert-item" title="g_menu_insert_item ()"><code class="function">g_menu_insert_item()</code></a> for
 596 a more flexible alternative.
 597 </p>
 598 <div class="variablelist"><table border="0">
 599 <col align="left" valign="top">
 600 <tbody>
 601 <tr>
 602 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 603 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 604 </td>
 605 </tr>
 606 <tr>
 607 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 608 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 609 </td>
 610 </tr>
 611 <tr>
 612 <td><p><span class="term"><em class="parameter"><code>submenu</code></em> :</span></p></td>
 613 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the submenu</td>
 614 </tr>
 615 </tbody>
 616 </table></div>
 617 <p class="since">Since 2.32</p>
 618 </div>
 619 <hr>
 620 <div class="refsect2">
 621 <a name="g-menu-remove"></a><h3>g_menu_remove ()</h3>
 622 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_remove                       (<em class="parameter"><code><a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> *menu</code></em>,
 623                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
 624 <p>
 625 Removes an item from the menu.
 626 </p>
 627 <p>
 628 <em class="parameter"><code>position</code></em> gives the index of the item to remove.
 629 </p>
 630 <p>
 631 It is an error if position is not in range the range from 0 to one
 632 less than the number of items in the menu.
 633 </p>
 634 <p>
 635 It is not possible to remove items by identity since items are added
 636 to the menu simply by copying their links and attributes (ie:
 637 identity of the item itself is not preserved).
 638 </p>
 639 <div class="variablelist"><table border="0">
 640 <col align="left" valign="top">
 641 <tbody>
 642 <tr>
 643 <td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
 644 <td>a <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a>
 645 </td>
 646 </tr>
 647 <tr>
 648 <td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
 649 <td>the position of the item to remove</td>
 650 </tr>
 651 </tbody>
 652 </table></div>
 653 <p class="since">Since 2.32</p>
 654 </div>
 655 <hr>
 656 <div class="refsect2">
 657 <a name="GMenuItem-struct"></a><h3>GMenuItem</h3>
 658 <pre class="programlisting">typedef struct _GMenuItem GMenuItem;</pre>
 659 <p>
 660 <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> is an opaque structure type.  You must access it using the
 661 functions below.
 662 </p>
 663 <p class="since">Since 2.32</p>
 664 </div>
 665 <hr>
 666 <div class="refsect2">
 667 <a name="g-menu-item-new"></a><h3>g_menu_item_new ()</h3>
 668 <pre class="programlisting"><a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         g_menu_item_new                     (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 669                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);</pre>
 670 <p>
 671 Creates a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>.
 672 </p>
 673 <p>
 674 If <em class="parameter"><code>label</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it is used to set the "label" attribute of the
 675 new item.
 676 </p>
 677 <p>
 678 If <em class="parameter"><code>detailed_action</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it is used to set the "action" and
 679 possibly the "target" attribute of the new item.  See
 680 <a class="link" href="GMenu.html#g-menu-item-set-detailed-action" title="g_menu_item_set_detailed_action ()"><code class="function">g_menu_item_set_detailed_action()</code></a> for more information.
 681 </p>
 682 <div class="variablelist"><table border="0">
 683 <col align="left" valign="top">
 684 <tbody>
 685 <tr>
 686 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 687 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 688 </td>
 689 </tr>
 690 <tr>
 691 <td><p><span class="term"><em class="parameter"><code>detailed_action</code></em> :</span></p></td>
 692 <td>the detailed action string, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 693 </td>
 694 </tr>
 695 <tr>
 696 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 697 <td>a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
 698 </td>
 699 </tr>
 700 </tbody>
 701 </table></div>
 702 <p class="since">Since 2.32</p>
 703 </div>
 704 <hr>
 705 <div class="refsect2">
 706 <a name="g-menu-item-new-section"></a><h3>g_menu_item_new_section ()</h3>
 707 <pre class="programlisting"><a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         g_menu_item_new_section             (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 708                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);</pre>
 709 <p>
 710 Creates a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> representing a section.
 711 </p>
 712 <p>
 713 This is a convenience API around <a class="link" href="GMenu.html#g-menu-item-new" title="g_menu_item_new ()"><code class="function">g_menu_item_new()</code></a> and
 714 <a class="link" href="GMenu.html#g-menu-item-set-section" title="g_menu_item_set_section ()"><code class="function">g_menu_item_set_section()</code></a>.
 715 </p>
 716 <p>
 717 The effect of having one menu appear as a section of another is
 718 exactly as it sounds: the items from <em class="parameter"><code>section</code></em> become a direct part of
 719 the menu that <em class="parameter"><code>menu_item</code></em> is added to.
 720 </p>
 721 <p>
 722 Visual separation is typically displayed between two non-empty
 723 sections.  If <em class="parameter"><code>label</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it will be encorporated into
 724 this visual indication.  This allows for labeled subsections of a
 725 menu.
 726 </p>
 727 <p>
 728 As a simple example, consider a typical "Edit" menu from a simple
 729 program.  It probably contains an "Undo" and "Redo" item, followed by
 730 a separator, followed by "Cut", "Copy" and "Paste".
 731 </p>
 732 <p>
 733 This would be accomplished by creating three <a class="link" href="GMenu.html" title="GMenu"><span class="type">GMenu</span></a> instances.  The
 734 first would be populated with the "Undo" and "Redo" items, and the
 735 second with the "Cut", "Copy" and "Paste" items.  The first and
 736 second menus would then be added as submenus of the third.  In XML
 737 format, this would look something like the following:
 738 </p>
 739 <p>
 740 </p>
 741 <div class="informalexample">
 742   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 743     <tbody>
 744       <tr>
 745         <td class="listing_lines" align="right"><pre>1
 746 2
 747 3
 748 4
 749 5
 750 6
 751 7
 752 8
 753 9
 754 10
 755 11</pre></td>
 756         <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">menu</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">'edit-menu'</span><span class="symbol">&gt;</span>
 757 <span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
 758 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Undo'</span><span class="symbol">/&gt;</span>
 759 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Redo'</span><span class="symbol">/&gt;</span>
 760 <span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
 761 <span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
 762 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Cut'</span><span class="symbol">/&gt;</span>
 763 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Copy'</span><span class="symbol">/&gt;</span>
 764 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Paste'</span><span class="symbol">/&gt;</span>
 765 <span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
 766 <span class="symbol">&lt;/</span><span class="normal">menu</span><span class="symbol">&gt;</span></pre></td>
 767       </tr>
 768     </tbody>
 769   </table>
 770 </div>
 771
 772 <p>
 773 </p>
 774 <p>
 775 The following example is exactly equivalent.  It is more illustrative
 776 of the exact relationship between the menus and items (keeping in
 777 mind that the 'link' element defines a new menu that is linked to the
 778 containing one).  The style of the second example is more verbose and
 779 difficult to read (and therefore not recommended except for the
 780 purpose of understanding what is really going on).
 781 </p>
 782 <p>
 783 </p>
 784 <div class="informalexample">
 785   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 786     <tbody>
 787       <tr>
 788         <td class="listing_lines" align="right"><pre>1
 789 2
 790 3
 791 4
 792 5
 793 6
 794 7
 795 8
 796 9
 797 10
 798 11
 799 12
 800 13
 801 14
 802 15</pre></td>
 803         <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">menu</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">'edit-menu'</span><span class="symbol">&gt;</span>
 804 <span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
 805 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">link</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">'section'</span><span class="symbol">&gt;</span>
 806 <span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Undo'</span><span class="symbol">/&gt;</span>
 807 <span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Redo'</span><span class="symbol">/&gt;</span>
 808 <span class="normal">    </span><span class="symbol">&lt;/</span><span class="normal">link</span><span class="symbol">&gt;</span>
 809 <span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
 810 <span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
 811 <span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">link</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">'section'</span><span class="symbol">&gt;</span>
 812 <span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Cut'</span><span class="symbol">/&gt;</span>
 813 <span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Copy'</span><span class="symbol">/&gt;</span>
 814 <span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> label</span><span class="symbol">=</span><span class="string">'Paste'</span><span class="symbol">/&gt;</span>
 815 <span class="normal">    </span><span class="symbol">&lt;/</span><span class="normal">link</span><span class="symbol">&gt;</span>
 816 <span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
 817 <span class="symbol">&lt;/</span><span class="normal">menu</span><span class="symbol">&gt;</span></pre></td>
 818       </tr>
 819     </tbody>
 820   </table>
 821 </div>
 822
 823 <p>
 824 </p>
 825 <div class="variablelist"><table border="0">
 826 <col align="left" valign="top">
 827 <tbody>
 828 <tr>
 829 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 830 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 831 </td>
 832 </tr>
 833 <tr>
 834 <td><p><span class="term"><em class="parameter"><code>section</code></em> :</span></p></td>
 835 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the section</td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 839 <td>a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
 840 </td>
 841 </tr>
 842 </tbody>
 843 </table></div>
 844 <p class="since">Since 2.32</p>
 845 </div>
 846 <hr>
 847 <div class="refsect2">
 848 <a name="g-menu-item-new-submenu"></a><h3>g_menu_item_new_submenu ()</h3>
 849 <pre class="programlisting"><a class="link" href="GMenu.html#GMenuItem"><span class="returnvalue">GMenuItem</span></a> *         g_menu_item_new_submenu             (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 850                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);</pre>
 851 <p>
 852 Creates a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> representing a submenu.
 853 </p>
 854 <p>
 855 This is a convenience API around <a class="link" href="GMenu.html#g-menu-item-new" title="g_menu_item_new ()"><code class="function">g_menu_item_new()</code></a> and
 856 <a class="link" href="GMenu.html#g-menu-item-set-submenu" title="g_menu_item_set_submenu ()"><code class="function">g_menu_item_set_submenu()</code></a>.
 857 </p>
 858 <div class="variablelist"><table border="0">
 859 <col align="left" valign="top">
 860 <tbody>
 861 <tr>
 862 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 863 <td>the section label, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 864 </td>
 865 </tr>
 866 <tr>
 867 <td><p><span class="term"><em class="parameter"><code>submenu</code></em> :</span></p></td>
 868 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> with the items of the submenu</td>
 869 </tr>
 870 <tr>
 871 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 872 <td>a new <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
 873 </td>
 874 </tr>
 875 </tbody>
 876 </table></div>
 877 <p class="since">Since 2.32</p>
 878 </div>
 879 <hr>
 880 <div class="refsect2">
 881 <a name="g-menu-item-set-label"></a><h3>g_menu_item_set_label ()</h3>
 882 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_label               (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 883                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 884 <p>
 885 Sets or unsets the "label" attribute of <em class="parameter"><code>menu_item</code></em>.
 886 </p>
 887 <p>
 888 If <em class="parameter"><code>label</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it is used as the label for the menu item.  If
 889 it is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the label attribute is unset.
 890 </p>
 891 <div class="variablelist"><table border="0">
 892 <col align="left" valign="top">
 893 <tbody>
 894 <tr>
 895 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
 896 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
 897 </td>
 898 </tr>
 899 <tr>
 900 <td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 901 <td>the label to set, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 902 </td>
 903 </tr>
 904 </tbody>
 905 </table></div>
 906 <p class="since">Since 2.32</p>
 907 </div>
 908 <hr>
 909 <div class="refsect2">
 910 <a name="g-menu-item-set-action-and-target-value"></a><h3>g_menu_item_set_action_and_target_value ()</h3>
 911 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_action_and_target_value
 912                                                         (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 913                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action</code></em>,
 914                                                          <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *target_value</code></em>);</pre>
 915 <p>
 916 Sets or unsets the "action" and "target" attributes of <em class="parameter"><code>menu_item</code></em>.
 917 </p>
 918 <p>
 919 If <em class="parameter"><code>action</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then both the "action" and "target" attributes
 920 are unset (and <em class="parameter"><code>target_value</code></em> is ignored).
 921 </p>
 922 <p>
 923 If <em class="parameter"><code>action</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the "action" attribute is set.  The
 924 "target" attribute is then set to the value of <em class="parameter"><code>target_value</code></em> if it is
 925 non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or unset otherwise.
 926 </p>
 927 <p>
 928 Normal menu items (ie: not submenu, section or other custom item
 929 types) are expected to have the "action" attribute set to identify
 930 the action that they are associated with.  The state type of the
 931 action help to determine the disposition of the menu item.  See
 932 <a class="link" href="GAction.html" title="GAction"><span class="type">GAction</span></a> and <a class="link" href="GActionGroup.html" title="GActionGroup"><span class="type">GActionGroup</span></a> for an overview of actions.
 933 </p>
 934 <p>
 935 In general, clicking on the menu item will result in activation of
 936 the named action with the "target" attribute given as the parameter
 937 to the action invocation.  If the "target" attribute is not set then
 938 the action is invoked with no parameter.
 939 </p>
 940 <p>
 941 If the action has no state then the menu item is usually drawn as a
 942 plain menu item (ie: with no additional decoration).
 943 </p>
 944 <p>
 945 If the action has a boolean state then the menu item is usually drawn
 946 as a toggle menu item (ie: with a checkmark or equivalent
 947 indication).  The item should be marked as 'toggled' or 'checked'
 948 when the boolean state is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
 949 </p>
 950 <p>
 951 If the action has a string state then the menu item is usually drawn
 952 as a radio menu item (ie: with a radio bullet or equivalent
 953 indication).  The item should be marked as 'selected' when the string
 954 state is equal to the value of the <em class="parameter"><code>target</code></em> property.
 955 </p>
 956 <p>
 957 See <a class="link" href="GMenu.html#g-menu-item-set-action-and-target" title="g_menu_item_set_action_and_target ()"><code class="function">g_menu_item_set_action_and_target()</code></a> or
 958 <a class="link" href="GMenu.html#g-menu-item-set-detailed-action" title="g_menu_item_set_detailed_action ()"><code class="function">g_menu_item_set_detailed_action()</code></a> for two equivalent calls that are
 959 probably more convenient for most uses.
 960 </p>
 961 <div class="variablelist"><table border="0">
 962 <col align="left" valign="top">
 963 <tbody>
 964 <tr>
 965 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
 966 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
 967 </td>
 968 </tr>
 969 <tr>
 970 <td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
 971 <td>the name of the action for this item. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 972 </td>
 973 </tr>
 974 <tr>
 975 <td><p><span class="term"><em class="parameter"><code>target_value</code></em> :</span></p></td>
 976 <td>a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to use as the action target. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 977 </td>
 978 </tr>
 979 </tbody>
 980 </table></div>
 981 <p class="since">Since 2.32</p>
 982 </div>
 983 <hr>
 984 <div class="refsect2">
 985 <a name="g-menu-item-set-action-and-target"></a><h3>g_menu_item_set_action_and_target ()</h3>
 986 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_action_and_target   (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
 987                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action</code></em>,
 988                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format_string</code></em>,
 989                                                          <em class="parameter"><code>...</code></em>);</pre>
 990 <p>
 991 Sets or unsets the "action" and "target" attributes of <em class="parameter"><code>menu_item</code></em>.
 992 </p>
 993 <p>
 994 If <em class="parameter"><code>action</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then both the "action" and "target" attributes
 995 are unset (and <em class="parameter"><code>format_string</code></em> is ignored along with the positional
 996 parameters).
 997 </p>
 998 <p>
 999 If <em class="parameter"><code>action</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the "action" attribute is set.
1000 <em class="parameter"><code>format_string</code></em> is then inspected.  If it is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the proper
1001 position parameters are collected to create a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance to
1002 use as the target value.  If it is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the positional
1003 parameters are ignored and the "target" attribute is unset.
1004 </p>
1005 <p>
1006 See also <a class="link" href="GMenu.html#g-menu-item-set-action-and-target-value" title="g_menu_item_set_action_and_target_value ()"><code class="function">g_menu_item_set_action_and_target_value()</code></a> for an equivalent
1007 call that directly accepts a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.  See
1008 <a class="link" href="GMenu.html#g-menu-item-set-detailed-action" title="g_menu_item_set_detailed_action ()"><code class="function">g_menu_item_set_detailed_action()</code></a> for a more convenient version that
1009 works with string-typed targets.
1010 </p>
1011 <p>
1012 See also <a class="link" href="GMenu.html#g-menu-item-set-action-and-target-value" title="g_menu_item_set_action_and_target_value ()"><code class="function">g_menu_item_set_action_and_target_value()</code></a> for a
1013 description of the semantics of the action and target attributes.
1014 </p>
1015 <div class="variablelist"><table border="0">
1016 <col align="left" valign="top">
1017 <tbody>
1018 <tr>
1019 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1020 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1021 </td>
1022 </tr>
1023 <tr>
1024 <td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
1025 <td>the name of the action for this item. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1026 </td>
1027 </tr>
1028 <tr>
1029 <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
1030 <td>a GVariant format string. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1031 </td>
1032 </tr>
1033 <tr>
1034 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1035 <td>positional parameters, as per <em class="parameter"><code>format_string</code></em>
1036 </td>
1037 </tr>
1038 </tbody>
1039 </table></div>
1040 <p class="since">Since 2.32</p>
1041 </div>
1042 <hr>
1043 <div class="refsect2">
1044 <a name="g-menu-item-set-detailed-action"></a><h3>g_menu_item_set_detailed_action ()</h3>
1045 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_detailed_action     (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1046                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action</code></em>);</pre>
1047 <p>
1048 Sets the "action" and possibly the "target" attribute of <em class="parameter"><code>menu_item</code></em>.
1049 </p>
1050 <p>
1051 If <em class="parameter"><code>detailed_action</code></em> contains a double colon ("::") then it is used as
1052 a separator between an action name and a target string.  In this
1053 case, this call is equivalent to calling
1054 <a class="link" href="GMenu.html#g-menu-item-set-action-and-target" title="g_menu_item_set_action_and_target ()"><code class="function">g_menu_item_set_action_and_target()</code></a> with the part before the "::" and
1055 with a string-type <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing the part following the "::".
1056 </p>
1057 <p>
1058 If <em class="parameter"><code>detailed_action</code></em> doesn't contain "::" then the action is set to
1059 the given string (verbatim) and the target value is unset.
1060 </p>
1061 <p>
1062 See <a class="link" href="GMenu.html#g-menu-item-set-action-and-target" title="g_menu_item_set_action_and_target ()"><code class="function">g_menu_item_set_action_and_target()</code></a> or
1063 <a class="link" href="GMenu.html#g-menu-item-set-action-and-target-value" title="g_menu_item_set_action_and_target_value ()"><code class="function">g_menu_item_set_action_and_target_value()</code></a> for more flexible (but
1064 slightly less convenient) alternatives.
1065 </p>
1066 <p>
1067 See also <a class="link" href="GMenu.html#g-menu-item-set-action-and-target-value" title="g_menu_item_set_action_and_target_value ()"><code class="function">g_menu_item_set_action_and_target_value()</code></a> for a description of
1068 the semantics of the action and target attributes.
1069 </p>
1070 <div class="variablelist"><table border="0">
1071 <col align="left" valign="top">
1072 <tbody>
1073 <tr>
1074 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1075 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1076 </td>
1077 </tr>
1078 <tr>
1079 <td><p><span class="term"><em class="parameter"><code>detailed_action</code></em> :</span></p></td>
1080 <td>the "detailed" action string</td>
1081 </tr>
1082 </tbody>
1083 </table></div>
1084 <p class="since">Since 2.32</p>
1085 </div>
1086 <hr>
1087 <div class="refsect2">
1088 <a name="g-menu-item-set-section"></a><h3>g_menu_item_set_section ()</h3>
1089 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_section             (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1090                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *section</code></em>);</pre>
1091 <p>
1092 Sets or unsets the "section" link of <em class="parameter"><code>menu_item</code></em> to <em class="parameter"><code>section</code></em>.
1093 </p>
1094 <p>
1095 The effect of having one menu appear as a section of another is
1096 exactly as it sounds: the items from <em class="parameter"><code>section</code></em> become a direct part of
1097 the menu that <em class="parameter"><code>menu_item</code></em> is added to.  See <a class="link" href="GMenu.html#g-menu-item-new-section" title="g_menu_item_new_section ()"><code class="function">g_menu_item_new_section()</code></a>
1098 for more information about what it means for a menu item to be a
1099 section.
1100 </p>
1101 <div class="variablelist"><table border="0">
1102 <col align="left" valign="top">
1103 <tbody>
1104 <tr>
1105 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1106 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1107 </td>
1108 </tr>
1109 <tr>
1110 <td><p><span class="term"><em class="parameter"><code>section</code></em> :</span></p></td>
1111 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1112 </td>
1113 </tr>
1114 </tbody>
1115 </table></div>
1116 <p class="since">Since 2.32</p>
1117 </div>
1118 <hr>
1119 <div class="refsect2">
1120 <a name="g-menu-item-set-submenu"></a><h3>g_menu_item_set_submenu ()</h3>
1121 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_submenu             (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1122                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *submenu</code></em>);</pre>
1123 <p>
1124 Sets or unsets the "submenu" link of <em class="parameter"><code>menu_item</code></em> to <em class="parameter"><code>submenu</code></em>.
1125 </p>
1126 <p>
1127 If <em class="parameter"><code>submenu</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it is linked to.  If it is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the
1128 link is unset.
1129 </p>
1130 <p>
1131 The effect of having one menu appear as a submenu of another is
1132 exactly as it sounds.
1133 </p>
1134 <div class="variablelist"><table border="0">
1135 <col align="left" valign="top">
1136 <tbody>
1137 <tr>
1138 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1139 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1140 </td>
1141 </tr>
1142 <tr>
1143 <td><p><span class="term"><em class="parameter"><code>submenu</code></em> :</span></p></td>
1144 <td>a <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1145 </td>
1146 </tr>
1147 </tbody>
1148 </table></div>
1149 <p class="since">Since 2.32</p>
1150 </div>
1151 <hr>
1152 <div class="refsect2">
1153 <a name="g-menu-item-set-attribute-value"></a><h3>g_menu_item_set_attribute_value ()</h3>
1154 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_attribute_value     (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1155                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
1156                                                          <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1157 <p>
1158 Sets or unsets an attribute on <em class="parameter"><code>menu_item</code></em>.
1159 </p>
1160 <p>
1161 The attribute to set or unset is specified by <em class="parameter"><code>attribute</code></em>. This
1162 can be one of the standard attribute names <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-LABEL:CAPS" title="G_MENU_ATTRIBUTE_LABEL"><code class="literal">G_MENU_ATTRIBUTE_LABEL</code></a>,
1163 <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-ACTION:CAPS" title="G_MENU_ATTRIBUTE_ACTION"><code class="literal">G_MENU_ATTRIBUTE_ACTION</code></a>, <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-TARGET:CAPS" title="G_MENU_ATTRIBUTE_TARGET"><code class="literal">G_MENU_ATTRIBUTE_TARGET</code></a>, or a custom
1164 attribute name.
1165 Attribute names are restricted to lowercase characters, numbers
1166 and '-'. Furthermore, the names must begin with a lowercase character,
1167 must not end with a '-', and must not contain consecutive dashes.
1168 </p>
1169 <p>
1170 must consist only of lowercase
1171 ASCII characters, digits and '-'.
1172 </p>
1173 <p>
1174 If <em class="parameter"><code>value</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is used as the new value for the
1175 attribute.  If <em class="parameter"><code>value</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the attribute is unset. If
1176 the <em class="parameter"><code>value</code></em> <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed.
1177 </p>
1178 <p>
1179 See also <a class="link" href="GMenu.html#g-menu-item-set-attribute" title="g_menu_item_set_attribute ()"><code class="function">g_menu_item_set_attribute()</code></a> for a more convenient way to do
1180 the same.
1181 </p>
1182 <div class="variablelist"><table border="0">
1183 <col align="left" valign="top">
1184 <tbody>
1185 <tr>
1186 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1187 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1188 </td>
1189 </tr>
1190 <tr>
1191 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
1192 <td>the attribute to set</td>
1193 </tr>
1194 <tr>
1195 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1196 <td>a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to use as the value, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1197 </td>
1198 </tr>
1199 </tbody>
1200 </table></div>
1201 <p class="since">Since 2.32</p>
1202 </div>
1203 <hr>
1204 <div class="refsect2">
1205 <a name="g-menu-item-set-attribute"></a><h3>g_menu_item_set_attribute ()</h3>
1206 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_attribute           (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1207                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
1208                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format_string</code></em>,
1209                                                          <em class="parameter"><code>...</code></em>);</pre>
1210 <p>
1211 Sets or unsets an attribute on <em class="parameter"><code>menu_item</code></em>.
1212 </p>
1213 <p>
1214 The attribute to set or unset is specified by <em class="parameter"><code>attribute</code></em>. This
1215 can be one of the standard attribute names <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-LABEL:CAPS" title="G_MENU_ATTRIBUTE_LABEL"><code class="literal">G_MENU_ATTRIBUTE_LABEL</code></a>,
1216 <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-ACTION:CAPS" title="G_MENU_ATTRIBUTE_ACTION"><code class="literal">G_MENU_ATTRIBUTE_ACTION</code></a>, <a class="link" href="GMenuModel.html#G-MENU-ATTRIBUTE-TARGET:CAPS" title="G_MENU_ATTRIBUTE_TARGET"><code class="literal">G_MENU_ATTRIBUTE_TARGET</code></a>, or a custom
1217 attribute name.
1218 Attribute names are restricted to lowercase characters, numbers
1219 and '-'. Furthermore, the names must begin with a lowercase character,
1220 must not end with a '-', and must not contain consecutive dashes.
1221 </p>
1222 <p>
1223 If <em class="parameter"><code>format_string</code></em> is non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the proper position parameters
1224 are collected to create a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance to use as the attribute
1225 value.  If it is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the positional parameterrs are ignored
1226 and the named attribute is unset.
1227 </p>
1228 <p>
1229 See also <a class="link" href="GMenu.html#g-menu-item-set-attribute-value" title="g_menu_item_set_attribute_value ()"><code class="function">g_menu_item_set_attribute_value()</code></a> for an equivalent call
1230 that directly accepts a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.
1231 </p>
1232 <div class="variablelist"><table border="0">
1233 <col align="left" valign="top">
1234 <tbody>
1235 <tr>
1236 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1237 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1238 </td>
1239 </tr>
1240 <tr>
1241 <td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
1242 <td>the attribute to set</td>
1243 </tr>
1244 <tr>
1245 <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
1246 <td>a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1247 </td>
1248 </tr>
1249 <tr>
1250 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1251 <td>positional parameters, as per <em class="parameter"><code>format_string</code></em>
1252 </td>
1253 </tr>
1254 </tbody>
1255 </table></div>
1256 <p class="since">Since 2.32</p>
1257 </div>
1258 <hr>
1259 <div class="refsect2">
1260 <a name="g-menu-item-set-link"></a><h3>g_menu_item_set_link ()</h3>
1261 <pre class="programlisting"><span class="returnvalue">void</span>                g_menu_item_set_link                (<em class="parameter"><code><a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a> *menu_item</code></em>,
1262                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *link</code></em>,
1263                                                          <em class="parameter"><code><a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> *model</code></em>);</pre>
1264 <p>
1265 Creates a link from <em class="parameter"><code>menu_item</code></em> to <em class="parameter"><code>model</code></em> if non-<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or unsets it.
1266 </p>
1267 <p>
1268 Links are used to establish a relationship between a particular menu
1269 item and another menu.  For example, <a class="link" href="GMenuModel.html#G-MENU-LINK-SUBMENU:CAPS" title="G_MENU_LINK_SUBMENU"><code class="literal">G_MENU_LINK_SUBMENU</code></a> is used to
1270 associate a submenu with a particular menu item, and <a class="link" href="GMenuModel.html#G-MENU-LINK-SECTION:CAPS" title="G_MENU_LINK_SECTION"><code class="literal">G_MENU_LINK_SECTION</code></a>
1271 is used to create a section. Other types of link can be used, but there
1272 is no guarantee that clients will be able to make sense of them.
1273 Link types are restricted to lowercase characters, numbers
1274 and '-'. Furthermore, the names must begin with a lowercase character,
1275 must not end with a '-', and must not contain consecutive dashes.
1276 </p>
1277 <div class="variablelist"><table border="0">
1278 <col align="left" valign="top">
1279 <tbody>
1280 <tr>
1281 <td><p><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></p></td>
1282 <td>a <a class="link" href="GMenu.html#GMenuItem"><span class="type">GMenuItem</span></a>
1283 </td>
1284 </tr>
1285 <tr>
1286 <td><p><span class="term"><em class="parameter"><code>link</code></em> :</span></p></td>
1287 <td>type of link to establish or unset</td>
1288 </tr>
1289 <tr>
1290 <td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td>
1291 <td>the <a class="link" href="GMenuModel.html" title="GMenuModel"><span class="type">GMenuModel</span></a> to link to (or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1292 </td>
1293 </tr>
1294 </tbody>
1295 </table></div>
1296 <p class="since">Since 2.32</p>
1297 </div>
1298 </div>
1299 </div>
1300 <div class="footer">
1301 <hr>
1302           Generated by GTK-Doc V1.18</div>
1303 </body>
1304 </html>