RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkLockButton.html ADDED Viewed

@@ -0,0 +1,259 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkLockButton</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="ButtonWidgets.html" title="Buttons and Toggles">
+<link rel="prev" href="GtkSwitch.html" title="GtkSwitch">
+<link rel="next" href="GtkMenuButton.html" title="GtkMenuButton">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkSwitch.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="ButtonWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkMenuButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkLockButton.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkLockButton.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkLockButton.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkLockButton.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkLockButton.properties" class="shortcut">Properties</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkLockButton"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkLockButton.top_of_page"></a>GtkLockButton</span></h2>
+<p>GtkLockButton — A widget to unlock or lock privileged operations</p>
+</td>
+<td valign="top" align="right"><img src="lockbutton.png"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkLockButton.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+struct              <a class="link" href="GtkLockButton.html#GtkLockButton-struct" title="struct GtkLockButton">GtkLockButton</a>;
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkLockButton.html#gtk-lock-button-new" title="gtk_lock_button_new ()">gtk_lock_button_new</a>                 (<em class="parameter"><code><span class="type">GPermission</span> *permission</code></em>);
+<span class="returnvalue">GPermission</span> *       <a class="link" href="GtkLockButton.html#gtk-lock-button-get-permission" title="gtk_lock_button_get_permission ()">gtk_lock_button_get_permission</a>      (<em class="parameter"><code><a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a> *button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkLockButton.html#gtk-lock-button-set-permission" title="gtk_lock_button_set_permission ()">gtk_lock_button_set_permission</a>      (<em class="parameter"><code><a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code><span class="type">GPermission</span> *permission</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
+                           +----<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>
+                                 +----GtkLockButton
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkLockButton implements
+ AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkActionable.html" title="GtkActionable">GtkActionable</a> and  <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--permission" title='The "permission" property'>permission</a>"               <span class="type">GPermission</span>*          : Read / Write
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--text-lock" title='The "text-lock" property'>text-lock</a>"                <span class="type">gchar</span>*                : Read / Write / Construct
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--text-unlock" title='The "text-unlock" property'>text-unlock</a>"              <span class="type">gchar</span>*                : Read / Write / Construct
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-lock" title='The "tooltip-lock" property'>tooltip-lock</a>"             <span class="type">gchar</span>*                : Read / Write / Construct
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-not-authorized" title='The "tooltip-not-authorized" property'>tooltip-not-authorized</a>"   <span class="type">gchar</span>*                : Read / Write / Construct
+  "<a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-unlock" title='The "tooltip-unlock" property'>tooltip-unlock</a>"           <span class="type">gchar</span>*                : Read / Write / Construct
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.description"></a><h2>Description</h2>
+<p>
+GtkLockButton is a widget that can be used in control panels or
+preference dialogs to allow users to obtain and revoke authorizations
+needed to operate the controls. The required authorization is represented
+by a <span class="type">GPermission</span> object. Concrete implementations of <span class="type">GPermission</span> may use
+PolicyKit or some other authorization framework. To obtain a PolicyKit-based
+<span class="type">GPermission</span>, use <code class="function">polkit_permission_new()</code>.
+</p>
+<p>
+If the user is not currently allowed to perform the action, but can obtain
+the permission, the widget looks like this
+</p>
+<div class="informalexample"><img src="lockbutton-locked.png"></div>
+<p>
+and the user can click the button to request the permission. Depending
+on the platform, this may pop up an authentication dialog or ask the user
+to authenticate in some other way. Once the user has obtained the permission,
+the widget changes to this
+</p>
+<div class="informalexample"><img src="lockbutton-unlocked.png"></div>
+<p>
+and the permission can be dropped again by clicking the button. If the user
+is not able to obtain the permission at all, the widget looks like this
+</p>
+<div class="informalexample"><img src="lockbutton-sorry.png"></div>
+<p>
+If the user has the permission and cannot drop it, the button is hidden.
+</p>
+<p>
+The text (and tooltips) that are shown in the various cases can be adjusted
+with the <a class="link" href="GtkLockButton.html#GtkLockButton--text-lock" title='The "text-lock" property'><span class="type">"text-lock"</span></a>, <a class="link" href="GtkLockButton.html#GtkLockButton--text-unlock" title='The "text-unlock" property'><span class="type">"text-unlock"</span></a>,
+<a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-lock" title='The "tooltip-lock" property'><span class="type">"tooltip-lock"</span></a>, <a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-unlock" title='The "tooltip-unlock" property'><span class="type">"tooltip-unlock"</span></a> and
+<a class="link" href="GtkLockButton.html#GtkLockButton--tooltip-not-authorized" title='The "tooltip-not-authorized" property'><span class="type">"tooltip-not-authorized"</span></a> properties.
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkLockButton-struct"></a><h3>struct GtkLockButton</h3>
+<pre class="programlisting">struct GtkLockButton;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-lock-button-new"></a><h3>gtk_lock_button_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_lock_button_new                 (<em class="parameter"><code><span class="type">GPermission</span> *permission</code></em>);</pre>
+<p>
+Creates a new lock button which reflects the <em class="parameter"><code>permission</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>permission</code></em> :</span></p></td>
+<td>a <span class="type">GPermission</span>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-lock-button-get-permission"></a><h3>gtk_lock_button_get_permission ()</h3>
+<pre class="programlisting"><span class="returnvalue">GPermission</span> *       gtk_lock_button_get_permission      (<em class="parameter"><code><a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a> *button</code></em>);</pre>
+<p>
+Obtains the <span class="type">GPermission</span> object that controls <em class="parameter"><code>button</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <span class="type">GPermission</span> of <em class="parameter"><code>button</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-lock-button-set-permission"></a><h3>gtk_lock_button_set_permission ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_lock_button_set_permission      (<em class="parameter"><code><a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code><span class="type">GPermission</span> *permission</code></em>);</pre>
+<p>
+Sets the <span class="type">GPermission</span> object that controls <em class="parameter"><code>button</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkLockButton.html" title="GtkLockButton"><span class="type">GtkLockButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>permission</code></em> :</span></p></td>
+<td>a <span class="type">GPermission</span> object, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.2</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkLockButton.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkLockButton--permission"></a><h3>The <code class="literal">"permission"</code> property</h3>
+<pre class="programlisting">  "permission"               <span class="type">GPermission</span>*          : Read / Write</pre>
+<p>The GPermission object controlling this button.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkLockButton--text-lock"></a><h3>The <code class="literal">"text-lock"</code> property</h3>
+<pre class="programlisting">  "text-lock"                <span class="type">gchar</span>*                : Read / Write / Construct</pre>
+<p>The text to display when prompting the user to lock.</p>
+<p>Default value: "Lock"</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkLockButton--text-unlock"></a><h3>The <code class="literal">"text-unlock"</code> property</h3>
+<pre class="programlisting">  "text-unlock"              <span class="type">gchar</span>*                : Read / Write / Construct</pre>
+<p>The text to display when prompting the user to unlock.</p>
+<p>Default value: "Unlock"</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkLockButton--tooltip-lock"></a><h3>The <code class="literal">"tooltip-lock"</code> property</h3>
+<pre class="programlisting">  "tooltip-lock"             <span class="type">gchar</span>*                : Read / Write / Construct</pre>
+<p>The tooltip to display when prompting the user to lock.</p>
+<p>Default value: "Dialog is unlocked.\nClick to prevent further changes"</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkLockButton--tooltip-not-authorized"></a><h3>The <code class="literal">"tooltip-not-authorized"</code> property</h3>
+<pre class="programlisting">  "tooltip-not-authorized"   <span class="type">gchar</span>*                : Read / Write / Construct</pre>
+<p>The tooltip to display when prompting the user cannot obtain authorization.</p>
+<p>Default value: "System policy prevents changes.\nContact your system administrator"</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkLockButton--tooltip-unlock"></a><h3>The <code class="literal">"tooltip-unlock"</code> property</h3>
+<pre class="programlisting">  "tooltip-unlock"           <span class="type">gchar</span>*                : Read / Write / Construct</pre>
+<p>The tooltip to display when prompting the user to unlock.</p>
+<p>Default value: "Dialog is locked.\nClick to make changes"</p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkMenu.html ADDED Viewed

@@ -0,0 +1,1527 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkMenu</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
+<link rel="prev" href="GtkComboBoxText.html" title="GtkComboBoxText">
+<link rel="next" href="GtkMenuBar.html" title="GtkMenuBar">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkComboBoxText.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkMenuBar.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkMenu.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkMenu.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkMenu.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkMenu.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkMenu.properties" class="shortcut">Properties</a>
+                   |
+                  <a href="#GtkMenu.child-properties" class="shortcut">Child Properties</a>
+                   |
+                  <a href="#GtkMenu.style-properties" class="shortcut">Style Properties</a>
+                   |
+                  <a href="#GtkMenu.signals" class="shortcut">Signals</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkMenu"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkMenu.top_of_page"></a>GtkMenu</span></h2>
+<p>GtkMenu — A menu widget</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkMenu.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+struct              <a class="link" href="GtkMenu.html#GtkMenu-struct" title="struct GtkMenu">GtkMenu</a>;
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMenu.html#gtk-menu-new" title="gtk_menu_new ()">gtk_menu_new</a>                        (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()">gtk_menu_new_from_model</a>             (<em class="parameter"><code><span class="type">GMenuModel</span> *model</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-screen" title="gtk_menu_set_screen ()">gtk_menu_set_screen</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-reorder-child" title="gtk_menu_reorder_child ()">gtk_menu_reorder_child</a>              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> position</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-attach" title="gtk_menu_attach ()">gtk_menu_attach</a>                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> left_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> right_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> top_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> bottom_attach</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-popup-for-device" title="gtk_menu_popup_for_device ()">gtk_menu_popup_for_device</a>           (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/GdkDevice.html"><span class="type">GdkDevice</span></a> *device</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
+                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> activate_time</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()">gtk_menu_popup</a>                      (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> activate_time</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-accel-group" title="gtk_menu_set_accel_group ()">gtk_menu_set_accel_group</a>            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);
+<a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="returnvalue">GtkAccelGroup</span></a> *     <a class="link" href="GtkMenu.html#gtk-menu-get-accel-group" title="gtk_menu_get_accel_group ()">gtk_menu_get_accel_group</a>            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-accel-path" title="gtk_menu_set_accel_path ()">gtk_menu_set_accel_path</a>             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *accel_path</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkMenu.html#gtk-menu-get-accel-path" title="gtk_menu_get_accel_path ()">gtk_menu_get_accel_path</a>             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-title" title="gtk_menu_set_title ()">gtk_menu_set_title</a>                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkMenu.html#gtk-menu-get-title" title="gtk_menu_get_title ()">gtk_menu_get_title</a>                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-monitor" title="gtk_menu_set_monitor ()">gtk_menu_set_monitor</a>                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="GtkMenu.html#gtk-menu-get-monitor" title="gtk_menu_get_monitor ()">gtk_menu_get_monitor</a>                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="GtkMenu.html#gtk-menu-get-tearoff-state" title="gtk_menu_get_tearoff_state ()">gtk_menu_get_tearoff_state</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-reserve-toggle-size" title="gtk_menu_set_reserve_toggle_size ()">gtk_menu_set_reserve_toggle_size</a>    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> reserve_toggle_size</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="GtkMenu.html#gtk-menu-get-reserve-toggle-size" title="gtk_menu_get_reserve_toggle_size ()">gtk_menu_get_reserve_toggle_size</a>    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-popdown" title="gtk_menu_popdown ()">gtk_menu_popdown</a>                    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-reposition" title="gtk_menu_reposition ()">gtk_menu_reposition</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMenu.html#gtk-menu-get-active" title="gtk_menu_get_active ()">gtk_menu_get_active</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-active" title="gtk_menu_set_active ()">gtk_menu_set_active</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-tearoff-state" title="gtk_menu_set_tearoff_state ()">gtk_menu_set_tearoff_state</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> torn_off</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()">gtk_menu_attach_to_widget</a>           (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()"><span class="type">GtkMenuDetachFunc</span></a> detacher</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-detach" title="gtk_menu_detach ()">gtk_menu_detach</a>                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMenu.html#gtk-menu-get-attach-widget" title="gtk_menu_get_attach_widget ()">gtk_menu_get_attach_widget</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+<span class="returnvalue">GList</span> *             <a class="link" href="GtkMenu.html#gtk-menu-get-for-attach-widget" title="gtk_menu_get_for_attach_widget ()">gtk_menu_get_for_attach_widget</a>      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
+<span class="returnvalue">void</span>                (<a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()">*GtkMenuPositionFunc</a>)              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *x</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *y</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> *push_in</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
+<span class="returnvalue">void</span>                (<a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()">*GtkMenuDetachFunc</a>)                (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----<a class="link" href="GtkMenuShell.html" title="GtkMenuShell">GtkMenuShell</a>
+                           +----GtkMenu
+                                 +----<a class="link" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkMenu implements
+ AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenu.html#GtkMenu--accel-group" title='The "accel-group" property'>accel-group</a>"              <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>*        : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--accel-path" title='The "accel-path" property'>accel-path</a>"               <span class="type">gchar</span>*                : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--active" title='The "active" property'>active</a>"                   <span class="type">gint</span>                  : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--attach-widget" title='The "attach-widget" property'>attach-widget</a>"            <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--monitor" title='The "monitor" property'>monitor</a>"                  <span class="type">gint</span>                  : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--reserve-toggle-size" title='The "reserve-toggle-size" property'>reserve-toggle-size</a>"      <span class="type">gboolean</span>              : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-state" title='The "tearoff-state" property'>tearoff-state</a>"            <span class="type">gboolean</span>              : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-title" title='The "tearoff-title" property'>tearoff-title</a>"            <span class="type">gchar</span>*                : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.child-properties"></a><h2>Child Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenu.html#GtkMenu--c-bottom-attach" title='The "bottom-attach" child property'>bottom-attach</a>"            <span class="type">gint</span>                  : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--c-left-attach" title='The "left-attach" child property'>left-attach</a>"              <span class="type">gint</span>                  : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--c-right-attach" title='The "right-attach" child property'>right-attach</a>"             <span class="type">gint</span>                  : Read / Write
+  "<a class="link" href="GtkMenu.html#GtkMenu--c-top-attach" title='The "top-attach" child property'>top-attach</a>"               <span class="type">gint</span>                  : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.style-properties"></a><h2>Style Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-arrow-placement" title='The "arrow-placement" style property'>arrow-placement</a>"          <a class="link" href="gtk3-Standard-Enumerations.html#GtkArrowPlacement" title="enum GtkArrowPlacement"><span class="type">GtkArrowPlacement</span></a>     : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-arrow-scaling" title='The "arrow-scaling" style property'>arrow-scaling</a>"            <span class="type">gfloat</span>                : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-double-arrows" title='The "double-arrows" style property'>double-arrows</a>"            <span class="type">gboolean</span>              : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-offset" title='The "horizontal-offset" style property'>horizontal-offset</a>"        <span class="type">gint</span>                  : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-padding" title='The "horizontal-padding" style property'>horizontal-padding</a>"       <span class="type">gint</span>                  : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-offset" title='The "vertical-offset" style property'>vertical-offset</a>"          <span class="type">gint</span>                  : Read
+  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-padding" title='The "vertical-padding" style property'>vertical-padding</a>"         <span class="type">gint</span>                  : Read
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.signals"></a><h2>Signals</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenu.html#GtkMenu-move-scroll" title='The "move-scroll" signal'>move-scroll</a>"                                    : <code class="literal">Action</code>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.description"></a><h2>Description</h2>
+<p>
+A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> is a <a class="link" href="GtkMenuShell.html" title="GtkMenuShell"><span class="type">GtkMenuShell</span></a> that implements a drop down menu
+consisting of a list of <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> objects which can be navigated
+and activated by the user to perform application functions.
+</p>
+<p>
+A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> is most commonly dropped down by activating a
+<a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> in a <a class="link" href="GtkMenuBar.html" title="GtkMenuBar"><span class="type">GtkMenuBar</span></a> or popped up by activating a
+<a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> in another <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
+</p>
+<p>
+A <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> can also be popped up by activating a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.
+Other composite widgets such as the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> can pop up a
+<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> as well.
+</p>
+<p>
+Applications can display a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> as a popup menu by calling the
+<a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a> function.  The example below shows how an application
+can pop up a menu when the 3rd mouse button is pressed.
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520346538464"></a><p class="title"><b>Example 76. Connecting the popup signal handler.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/* connect our handler which will popup the menu */</span>
+<span class="function">g_signal_connect_swapped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"button_press_event"</span><span class="symbol">,</span>
+<span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_popup_handler</span><span class="symbol">),</span><span class="normal"> menu</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520346535616"></a><p class="title"><b>Example 77. Signal handler which displays a popup menu.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gint</span>
+<span class="function">my_popup_handler</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GtkMenu</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">menu</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">GdkEventButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event_button</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget </span><span class="symbol">!=</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IS_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">),</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event </span><span class="symbol">!=</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="comment">/* The "widget" is the menu that was supplied when </span>
+<span class="comment">   * g_signal_connect_swapped() was called.</span>
+<span class="comment">   */</span>
+<span class="normal">  menu </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> <a href="../gdk3/gdk3-Events.html#GDK-BUTTON-PRESS:CAPS">GDK_BUTTON_PRESS</a></span><span class="symbol">)</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../gdk3/gdk3-Event-Structures.html#GdkEventButton">GdkEventButton</a> </span><span class="symbol">*)</span><span class="normal"> event</span><span class="symbol">;</span>
+<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_button</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> <a href="../gdk3/gdk3-Events.html#GDK-BUTTON-SECONDARY:CAPS">GDK_BUTTON_SECONDARY</a></span><span class="symbol">)</span>
+<span class="normal">        </span><span class="cbracket">{</span>
+<span class="normal">          </span><span class="function"><a href="GtkMenu.html#gtk-menu-popup">gtk_menu_popup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span>
+<span class="normal">                          event_button</span><span class="symbol">-&gt;</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
+<span class="normal">          </span><span class="keyword">return</span><span class="normal"> TRUE</span><span class="symbol">;</span>
+<span class="normal">        </span><span class="cbracket">}</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> FALSE</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkMenu-struct"></a><h3>struct GtkMenu</h3>
+<pre class="programlisting">struct GtkMenu;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-new"></a><h3>gtk_menu_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_menu_new                        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-new-from-model"></a><h3>gtk_menu_new_from_model ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_menu_new_from_model             (<em class="parameter"><code><span class="type">GMenuModel</span> *model</code></em>);</pre>
+<p>
+Creates a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> and populates it with menu items and
+submenus according to <em class="parameter"><code>model</code></em>.
+</p>
+<p>
+The created menu items are connected to actions found in the
+<a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow"><span class="type">GtkApplicationWindow</span></a> to which the menu belongs - typically
+by means of being attached to a widget (see <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()"><code class="function">gtk_menu_attach_to_widget()</code></a>)
+that is contained within the <a href="GtkApplicationWindow.html"><span class="type">GtkApplicationWindows</span></a> widget hierarchy.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td>
+<td>a <span class="type">GMenuModel</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-screen"></a><h3>gtk_menu_set_screen ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_screen                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
+<p>
+Sets the <a href="../gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> on which the menu will be displayed.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
+<td>a <a href="../gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if the screen should be
+determined by the widget the menu is attached to. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-reorder-child"></a><h3>gtk_menu_reorder_child ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_reorder_child              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
+<p>
+Moves <em class="parameter"><code>child</code></em> to a new <em class="parameter"><code>position</code></em> in the list of <em class="parameter"><code>menu</code></em>
+children.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to move</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
+<td>the new position to place <em class="parameter"><code>child</code></em>.
+Positions are numbered from 0 to n - 1</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-attach"></a><h3>gtk_menu_attach ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_attach                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> left_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> right_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> top_attach</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> bottom_attach</code></em>);</pre>
+<p>
+Adds a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to a (table) menu. The number of 'cells' that
+an item will occupy is specified by <em class="parameter"><code>left_attach</code></em>, <em class="parameter"><code>right_attach</code></em>,
+<em class="parameter"><code>top_attach</code></em> and <em class="parameter"><code>bottom_attach</code></em>. These each represent the leftmost,
+rightmost, uppermost and lower column and row numbers of the table.
+(Columns and rows are indexed from zero).
+</p>
+<p>
+Note that this function is not related to <a class="link" href="GtkMenu.html#gtk-menu-detach" title="gtk_menu_detach ()"><code class="function">gtk_menu_detach()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>left_attach</code></em> :</span></p></td>
+<td>The column number to attach the left side of the item to</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>right_attach</code></em> :</span></p></td>
+<td>The column number to attach the right side of the item to</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>top_attach</code></em> :</span></p></td>
+<td>The row number to attach the top of the item to</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>bottom_attach</code></em> :</span></p></td>
+<td>The row number to attach the bottom of the item to</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-popup-for-device"></a><h3>gtk_menu_popup_for_device ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_popup_for_device           (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/GdkDevice.html"><span class="type">GdkDevice</span></a> *device</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
+                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> activate_time</code></em>);</pre>
+<p>
+Displays a menu and makes it available for selection.
+</p>
+<p>
+Applications can use this function to display context-sensitive menus,
+and will typically supply <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>parent_menu_shell</code></em>,
+<em class="parameter"><code>parent_menu_item</code></em>, <em class="parameter"><code>func</code></em>, <em class="parameter"><code>data</code></em> and <em class="parameter"><code>destroy</code></em> parameters. The default
+menu positioning function will position the menu at the current position
+of <em class="parameter"><code>device</code></em> (or its corresponding pointer).
+</p>
+<p>
+The <em class="parameter"><code>button</code></em> parameter should be the mouse button pressed to initiate
+the menu popup. If the menu popup was initiated by something other than
+a mouse button press, such as a mouse button release or a keypress,
+<em class="parameter"><code>button</code></em> should be 0.
+</p>
+<p>
+The <em class="parameter"><code>activate_time</code></em> parameter is used to conflict-resolve initiation of
+concurrent requests for mouse/keyboard grab requests. To function
+properly, this needs to be the time stamp of the user event (such as
+a mouse click or key press) that caused the initiation of the popup.
+Only if no such event is available, <a class="link" href="gtk3-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()"><code class="function">gtk_get_current_event_time()</code></a> can
+be used instead.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
+<td>a <a href="../gdk3/GdkDevice.html"><span class="type">GdkDevice</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent_menu_shell</code></em> :</span></p></td>
+<td>the menu shell containing the triggering
+menu item, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent_menu_item</code></em> :</span></p></td>
+<td>the menu item whose activation triggered
+the popup, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
+<td>a user supplied function used to position the menu,
+or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
+<td>user supplied data to be passed to <em class="parameter"><code>func</code></em>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
+<td>destroy notify for <em class="parameter"><code>data</code></em>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>the mouse button which was pressed to initiate the event</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>activate_time</code></em> :</span></p></td>
+<td>the time at which the activation event occurred</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-popup"></a><h3>gtk_menu_popup ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_popup                      (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> activate_time</code></em>);</pre>
+<p>
+Displays a menu and makes it available for selection.
+</p>
+<p>
+Applications can use this function to display context-sensitive
+menus, and will typically supply <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>parent_menu_shell</code></em>,
+<em class="parameter"><code>parent_menu_item</code></em>, <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em> parameters. The default menu
+positioning function will position the menu at the current mouse
+cursor position.
+</p>
+<p>
+The <em class="parameter"><code>button</code></em> parameter should be the mouse button pressed to initiate
+the menu popup. If the menu popup was initiated by something other
+than a mouse button press, such as a mouse button release or a keypress,
+<em class="parameter"><code>button</code></em> should be 0.
+</p>
+<p>
+The <em class="parameter"><code>activate_time</code></em> parameter is used to conflict-resolve initiation
+of concurrent requests for mouse/keyboard grab requests. To function
+properly, this needs to be the timestamp of the user event (such as
+a mouse click or key press) that caused the initiation of the popup.
+Only if no such event is available, <a class="link" href="gtk3-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()"><code class="function">gtk_get_current_event_time()</code></a> can
+be used instead.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent_menu_shell</code></em> :</span></p></td>
+<td>the menu shell containing the
+triggering menu item, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent_menu_item</code></em> :</span></p></td>
+<td>the menu item whose activation
+triggered the popup, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
+<td>a user supplied function used to position
+the menu, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
+<td>user supplied data to be passed to <em class="parameter"><code>func</code></em>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>the mouse button which was pressed to initiate the event.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>activate_time</code></em> :</span></p></td>
+<td>the time at which the activation event occurred.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-accel-group"></a><h3>gtk_menu_set_accel_group ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_accel_group            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
+<p>
+Set the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> which holds global accelerators for the
+menu.  This accelerator group needs to also be added to all windows
+that this menu is being used in with <a class="link" href="GtkWindow.html#gtk-window-add-accel-group" title="gtk_window_add_accel_group ()"><code class="function">gtk_window_add_accel_group()</code></a>,
+in order for those windows to support all the accelerators
+contained in this group.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>accel_group</code></em> :</span></p></td>
+<td>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to be associated
+with the menu. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-accel-group"></a><h3>gtk_menu_get_accel_group ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="returnvalue">GtkAccelGroup</span></a> *     gtk_menu_get_accel_group            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Gets the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> which holds global accelerators for the
+menu. See <a class="link" href="GtkMenu.html#gtk-menu-set-accel-group" title="gtk_menu_set_accel_group ()"><code class="function">gtk_menu_set_accel_group()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> associated with the menu. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-accel-path"></a><h3>gtk_menu_set_accel_path ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_accel_path             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *accel_path</code></em>);</pre>
+<p>
+Sets an accelerator path for this menu from which accelerator paths
+for its immediate children, its menu items, can be constructed.
+The main purpose of this function is to spare the programmer the
+inconvenience of having to call <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-accel-path" title="gtk_menu_item_set_accel_path ()"><code class="function">gtk_menu_item_set_accel_path()</code></a> on
+each menu item that should support runtime user changable accelerators.
+Instead, by just calling <a class="link" href="GtkMenu.html#gtk-menu-set-accel-path" title="gtk_menu_set_accel_path ()"><code class="function">gtk_menu_set_accel_path()</code></a> on their parent,
+each menu item of this menu, that contains a label describing its
+purpose, automatically gets an accel path assigned.
+</p>
+<p>
+For example, a menu containing menu items "New" and "Exit", will, after
+<code class="literal">gtk_menu_set_accel_path (menu, "&lt;Gnumeric-Sheet&gt;/File");</code>
+has been called, assign its items the accel paths:
+<code class="literal">"&lt;Gnumeric-Sheet&gt;/File/New"</code> and <code class="literal">"&lt;Gnumeric-Sheet&gt;/File/Exit"</code>.
+</p>
+<p>
+Assigning accel paths to menu items then enables the user to change
+their accelerators at runtime. More details about accelerator paths
+and their default setups can be found at <a class="link" href="gtk3-Accelerator-Maps.html#gtk-accel-map-add-entry" title="gtk_accel_map_add_entry ()"><code class="function">gtk_accel_map_add_entry()</code></a>.
+</p>
+<p>
+Note that <em class="parameter"><code>accel_path</code></em> string will be stored in a <span class="type">GQuark</span>. Therefore,
+if you pass a static string, you can save some memory by interning
+it first with <code class="function">g_intern_static_string()</code>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a valid <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>accel_path</code></em> :</span></p></td>
+<td>a valid accelerator path. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-accel-path"></a><h3>gtk_menu_get_accel_path ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_menu_get_accel_path             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Retrieves the accelerator path set on the menu.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a valid <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the accelerator path set on the menu.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-title"></a><h3>gtk_menu_set_title ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_title                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
+<p>
+Sets the title string for the menu.
+</p>
+<p>
+The title is displayed when the menu is shown as a tearoff
+menu. If <em class="parameter"><code>title</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, the menu will see if it is attached
+to a parent menu item, and if so it will try to use the same
+text as that menu item's label.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
+<td>a string containing the title for the menu</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-title"></a><h3>gtk_menu_get_title ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_menu_get_title                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Returns the title of the menu. See <a class="link" href="GtkMenu.html#gtk-menu-set-title" title="gtk_menu_set_title ()"><code class="function">gtk_menu_set_title()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the title of the menu, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if the menu
+has no title set on it. This string is owned by GTK+
+and should not be modified or freed.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-monitor"></a><h3>gtk_menu_set_monitor ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_monitor                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
+<p>
+Informs GTK+ on which monitor a menu should be popped up.
+See <a href="../gdk3/GdkScreen.html#gdk-screen-get-monitor-geometry"><code class="function">gdk_screen_get_monitor_geometry()</code></a>.
+</p>
+<p>
+This function should be called from a <a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a>
+if the menu should not appear on the same monitor as the pointer.
+This information can't be reliably inferred from the coordinates
+returned by a <a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a>, since, for very long menus,
+these coordinates may extend beyond the monitor boundaries or even
+the screen boundaries.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>monitor_num</code></em> :</span></p></td>
+<td>the number of the monitor on which the menu should
+be popped up</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-monitor"></a><h3>gtk_menu_get_monitor ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_menu_get_monitor                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Retrieves the number of the monitor on which to show the menu.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the number of the monitor on which the menu should
+be popped up or -1, if no monitor has been set</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-tearoff-state"></a><h3>gtk_menu_get_tearoff_state ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_menu_get_tearoff_state          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Returns whether the menu is torn off.
+See <a class="link" href="GtkMenu.html#gtk-menu-set-tearoff-state" title="gtk_menu_set_tearoff_state ()"><code class="function">gtk_menu_set_tearoff_state()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the menu is currently torn off.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-reserve-toggle-size"></a><h3>gtk_menu_set_reserve_toggle_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_reserve_toggle_size    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> reserve_toggle_size</code></em>);</pre>
+<p>
+Sets whether the menu should reserve space for drawing toggles
+or icons, regardless of their actual presence.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>reserve_toggle_size</code></em> :</span></p></td>
+<td>whether to reserve size for toggles</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-reserve-toggle-size"></a><h3>gtk_menu_get_reserve_toggle_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_menu_get_reserve_toggle_size    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Returns whether the menu reserves space for toggles and
+icons, regardless of their actual presence.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>Whether the menu reserves toggle space</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-popdown"></a><h3>gtk_menu_popdown ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_popdown                    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Removes the menu from the screen.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-reposition"></a><h3>gtk_menu_reposition ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_reposition                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Repositions the menu according to its position function.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-active"></a><h3>gtk_menu_get_active ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_menu_get_active                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Returns the selected menu item from the menu.  This is used by the
+<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that was last selected
+in the menu.  If a selection has not yet been made, the
+first menu item is selected. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-active"></a><h3>gtk_menu_set_active ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_active                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>);</pre>
+<p>
+Selects the specified menu item within the menu.  This is used by
+the <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> and should not be used by anyone else.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
+<td>the index of the menu item to select.  Iindex values are
+from 0 to n-1</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-set-tearoff-state"></a><h3>gtk_menu_set_tearoff_state ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_tearoff_state          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> torn_off</code></em>);</pre>
+<p>
+Changes the tearoff state of the menu.  A menu is normally
+displayed as drop down menu which persists as long as the menu is
+active.  It can also be displayed as a tearoff menu which persists
+until it is closed or reattached.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>torn_off</code></em> :</span></p></td>
+<td>If <code class="literal">TRUE</code>, menu is displayed as a tearoff menu.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-attach-to-widget"></a><h3>gtk_menu_attach_to_widget ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_attach_to_widget           (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()"><span class="type">GtkMenuDetachFunc</span></a> detacher</code></em>);</pre>
+<p>
+Attaches the menu to the widget and provides a callback function
+that will be invoked when the menu calls <a class="link" href="GtkMenu.html#gtk-menu-detach" title="gtk_menu_detach ()"><code class="function">gtk_menu_detach()</code></a> during
+its destruction.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>attach_widget</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu will be attached to</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>detacher</code></em> :</span></p></td>
+<td>the user supplied callback function
+that will be called when the menu calls <a class="link" href="GtkMenu.html#gtk-menu-detach" title="gtk_menu_detach ()"><code class="function">gtk_menu_detach()</code></a>. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-detach"></a><h3>gtk_menu_detach ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_detach                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Detaches the menu from the widget to which it had been attached.
+This function will call the callback function, <em class="parameter"><code>detacher</code></em>, provided
+when the <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()"><code class="function">gtk_menu_attach_to_widget()</code></a> function was called.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-attach-widget"></a><h3>gtk_menu_get_attach_widget ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_menu_get_attach_widget          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+Returns the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu is attached to.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu is attached to. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-get-for-attach-widget"></a><h3>gtk_menu_get_for_attach_widget ()</h3>
+<pre class="programlisting"><span class="returnvalue">GList</span> *             gtk_menu_get_for_attach_widget      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
+<p>
+Returns a list of the menus which are attached to this widget.
+This list is owned by GTK+ and must not be modified.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the list
+of menus attached to his widget. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenuPositionFunc"></a><h3>GtkMenuPositionFunc ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkMenuPositionFunc)              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *x</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *y</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> *push_in</code></em>,
+                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
+<p>
+A user function supplied when calling <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a> which
+controls the positioning of the menu when it is displayed.  The
+function sets the <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> parameters to the coordinates where the
+menu is to be drawn.  To make the menu appear on a different
+monitor than the mouse pointer, <a class="link" href="GtkMenu.html#gtk-menu-set-monitor" title="gtk_menu_set_monitor ()"><code class="function">gtk_menu_set_monitor()</code></a> must be
+called.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
+<td>address of the <span class="type">gint</span> representing the horizontal
+position where the menu shall be drawn. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
+<td>address of the <span class="type">gint</span> representing the vertical position
+where the menu shall be drawn.  This is an output parameter. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>push_in</code></em> :</span></p></td>
+<td>This parameter controls how menus placed outside
+the monitor are handled.  If this is set to <code class="literal">TRUE</code> and part of
+the menu is outside the monitor then GTK+ pushes the window
+into the visible area, effectively modifying the popup
+position.  Note that moving and possibly resizing the menu
+around will alter the scroll position to keep the menu items
+"in place", i.e. at the same monitor position they would have
+been without resizing.  In practice, this behavior is only
+useful for combobox popups or option menus and cannot be used
+to simply confine a menu to monitor boundaries.  In that case,
+changing the scroll offset is not desirable. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>the data supplied by the user in the <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a>
+<em class="parameter"><code>data</code></em> parameter.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenuDetachFunc"></a><h3>GtkMenuDetachFunc ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkMenuDetachFunc)                (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
+<p>
+A user function supplied when calling <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()"><code class="function">gtk_menu_attach_to_widget()</code></a> which
+will be called when the menu is later detached from the widget.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>attach_widget</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu is being detached from.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> being detached.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkMenu--accel-group"></a><h3>The <code class="literal">"accel-group"</code> property</h3>
+<pre class="programlisting">  "accel-group"              <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>*        : Read / Write</pre>
+<p>
+The accel group holding accelerators for the menu.
+</p>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--accel-path"></a><h3>The <code class="literal">"accel-path"</code> property</h3>
+<pre class="programlisting">  "accel-path"               <span class="type">gchar</span>*                : Read / Write</pre>
+<p>
+An accel path used to conveniently construct accel paths of child items.
+</p>
+<p>Default value: NULL</p>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--active"></a><h3>The <code class="literal">"active"</code> property</h3>
+<pre class="programlisting">  "active"                   <span class="type">gint</span>                  : Read / Write</pre>
+<p>
+The index of the currently selected menu item, or -1 if no
+menu item is selected.
+</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--attach-widget"></a><h3>The <code class="literal">"attach-widget"</code> property</h3>
+<pre class="programlisting">  "attach-widget"            <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write</pre>
+<p>
+The widget the menu is attached to. Setting this property attaches
+the menu without a <a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()"><span class="type">GtkMenuDetachFunc</span></a>. If you need to use a detacher,
+use <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()"><code class="function">gtk_menu_attach_to_widget()</code></a> directly.
+</p>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--monitor"></a><h3>The <code class="literal">"monitor"</code> property</h3>
+<pre class="programlisting">  "monitor"                  <span class="type">gint</span>                  : Read / Write</pre>
+<p>
+The monitor the menu will be popped up on.
+</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--reserve-toggle-size"></a><h3>The <code class="literal">"reserve-toggle-size"</code> property</h3>
+<pre class="programlisting">  "reserve-toggle-size"      <span class="type">gboolean</span>              : Read / Write</pre>
+<p>
+A boolean that indicates whether the menu reserves space for
+toggles and icons, regardless of their actual presence.
+</p>
+<p>
+This property should only be changed from its default value
+for special-purposes such as tabular menus. Regular menus that
+are connected to a menu bar or context menus should reserve
+toggle space for consistency.
+</p>
+<p>Default value: TRUE</p>
+<p class="since">Since 2.18</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--tearoff-state"></a><h3>The <code class="literal">"tearoff-state"</code> property</h3>
+<pre class="programlisting">  "tearoff-state"            <span class="type">gboolean</span>              : Read / Write</pre>
+<p>
+A boolean that indicates whether the menu is torn-off.
+</p>
+<p>Default value: FALSE</p>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--tearoff-title"></a><h3>The <code class="literal">"tearoff-title"</code> property</h3>
+<pre class="programlisting">  "tearoff-title"            <span class="type">gchar</span>*                : Read / Write</pre>
+<p>A title that may be displayed by the window manager when this menu is torn-off.</p>
+<p>Default value: NULL</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.child-property-details"></a><h2>Child Property Details</h2>
+<div class="refsect2">
+<a name="GtkMenu--c-bottom-attach"></a><h3>The <code class="literal">"bottom-attach"</code> child property</h3>
+<pre class="programlisting">  "bottom-attach"            <span class="type">gint</span>                  : Read / Write</pre>
+<p>The row number to attach the bottom of the child to.</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--c-left-attach"></a><h3>The <code class="literal">"left-attach"</code> child property</h3>
+<pre class="programlisting">  "left-attach"              <span class="type">gint</span>                  : Read / Write</pre>
+<p>The column number to attach the left side of the child to.</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--c-right-attach"></a><h3>The <code class="literal">"right-attach"</code> child property</h3>
+<pre class="programlisting">  "right-attach"             <span class="type">gint</span>                  : Read / Write</pre>
+<p>The column number to attach the right side of the child to.</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--c-top-attach"></a><h3>The <code class="literal">"top-attach"</code> child property</h3>
+<pre class="programlisting">  "top-attach"               <span class="type">gint</span>                  : Read / Write</pre>
+<p>The row number to attach the top of the child to.</p>
+<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Default value: -1</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.style-property-details"></a><h2>Style Property Details</h2>
+<div class="refsect2">
+<a name="GtkMenu--s-arrow-placement"></a><h3>The <code class="literal">"arrow-placement"</code> style property</h3>
+<pre class="programlisting">  "arrow-placement"          <a class="link" href="gtk3-Standard-Enumerations.html#GtkArrowPlacement" title="enum GtkArrowPlacement"><span class="type">GtkArrowPlacement</span></a>     : Read</pre>
+<p>
+Indicates where scroll arrows should be placed.
+</p>
+<p>Default value: GTK_ARROWS_BOTH</p>
+<p class="since">Since 2.16</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-arrow-scaling"></a><h3>The <code class="literal">"arrow-scaling"</code> style property</h3>
+<pre class="programlisting">  "arrow-scaling"            <span class="type">gfloat</span>                : Read</pre>
+<p>
+Arbitrary constant to scale down the size of the scroll arrow.
+</p>
+<p>Allowed values: [0,1]</p>
+<p>Default value: 0.7</p>
+<p class="since">Since 2.16</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-double-arrows"></a><h3>The <code class="literal">"double-arrows"</code> style property</h3>
+<pre class="programlisting">  "double-arrows"            <span class="type">gboolean</span>              : Read</pre>
+<p>When scrolling, always show both arrows.</p>
+<p>Default value: TRUE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-horizontal-offset"></a><h3>The <code class="literal">"horizontal-offset"</code> style property</h3>
+<pre class="programlisting">  "horizontal-offset"        <span class="type">gint</span>                  : Read</pre>
+<p>When the menu is a submenu, position it this number of pixels offset horizontally.</p>
+<p>Default value: -2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-horizontal-padding"></a><h3>The <code class="literal">"horizontal-padding"</code> style property</h3>
+<pre class="programlisting">  "horizontal-padding"       <span class="type">gint</span>                  : Read</pre>
+<p>Extra space at the left and right edges of the menu.</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-vertical-offset"></a><h3>The <code class="literal">"vertical-offset"</code> style property</h3>
+<pre class="programlisting">  "vertical-offset"          <span class="type">gint</span>                  : Read</pre>
+<p>When the menu is a submenu, position it this number of pixels offset vertically.</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMenu--s-vertical-padding"></a><h3>The <code class="literal">"vertical-padding"</code> style property</h3>
+<pre class="programlisting">  "vertical-padding"         <span class="type">gint</span>                  : Read</pre>
+<p>Extra space at the top and bottom of the menu.</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 1</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenu.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GtkMenu-move-scroll"></a><h3>The <code class="literal">"move-scroll"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>      *menu,
+                                                        <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a> scroll_type,
+                                                        <span class="type">gpointer</span>      user_data)        : <code class="literal">Action</code></pre>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>