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

gdk3 1.2.0-x86-mingw32

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>