callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.23.1

Browse Source
This commit is contained in:
Iain Lane
2018-07-19 14:28:25 +01:00
parent 609c36368b f7f3939b04
commit 2193e3ebc6
853 changed files with 501219 additions and 479431 deletions
Download Patch File Download Diff File Expand all files Collapse all files

112
docs/reference/gtk/html/GtkMenu.html
View File

@ -8,7 +8,7 @@
<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.25 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -337,7 +337,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkAnchorHints</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></td>
<td class="property_name"><a class="link" href="GtkMenu.html#GtkMenu--anchor-hints" title="The “anchor-hints” property">anchor-hints</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
@ -348,7 +348,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkWindowTypeHint</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></td>
<td class="property_name"><a class="link" href="GtkMenu.html#GtkMenu--menu-type-hint" title="The “menu-type-hint” property">menu-type-hint</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
@ -521,7 +521,7 @@
<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>
AtkImplementor and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkMenu.includes"></a><h2>Includes</h2>
@ -652,8 +652,8 @@ attach widget or on any of its parent widgets.</p>
<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><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<p>Sets the <span class="type">GdkScreen</span> on which the menu will be displayed.</p>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Sets the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> on which the menu will be displayed.</p>
<div class="refsect3">
<a name="gtk-menu-set-screen.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -670,7 +670,7 @@ gtk_menu_set_screen (<em class="parameter"><code><a class="link" href="GtkMenu.h
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p> a <span class="type">GdkScreen</span>, or <code class="literal">NULL</code> if the screen should be
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>, or <code class="literal">NULL</code> if the screen should be
determined by the widget the menu is attached to. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -790,11 +790,11 @@ rightmost, uppermost and lower column and row numbers of the table.
<a name="gtk-menu-popup-at-rect"></a><h3>gtk_menu_popup_at_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_rect (<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">GdkWindow</span> *rect_window</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> rect_anchor</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *rect_window</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> rect_anchor</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a> and <a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, which
@ -835,13 +835,13 @@ direction is right-to-left.</p>
</tr>
<tr>
<td class="parameter_name"><p>rect_window</p></td>
<td class="parameter_description"><p> the <span class="type">GdkWindow</span> <em class="parameter"><code>rect</code></em>
<td class="parameter_description"><p>the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> <em class="parameter"><code>rect</code></em>
is relative to. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>rect</p></td>
<td class="parameter_description"><p> the <span class="type">GdkRectangle</span> to align <em class="parameter"><code>menu</code></em>
<td class="parameter_description"><p>the <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> to align <em class="parameter"><code>menu</code></em>
with. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
</tr>
@ -861,7 +861,7 @@ to align with <em class="parameter"><code>rect</code></em>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p> the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
@ -876,9 +876,9 @@ to align with <em class="parameter"><code>rect</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_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> *widget</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> widget_anchor</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> widget_anchor</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a> to pop up a menu at the master pointer.
@ -918,7 +918,7 @@ direction is right-to-left.</p>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to align <em class="parameter"><code>menu</code></em>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to align <em class="parameter"><code>menu</code></em>
with. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
</tr>
@ -938,7 +938,7 @@ to align with <em class="parameter"><code>widget</code></em>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p> the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
@ -952,7 +952,7 @@ to align with <em class="parameter"><code>widget</code></em>
<a name="gtk-menu-popup-at-pointer"></a><h3>gtk_menu_popup_at_pointer ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_pointer (<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">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a> to pop up a menu at a widget.
@ -981,7 +981,7 @@ out how it was actually positioned.</p>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p> the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
@ -995,7 +995,7 @@ out how it was actually positioned.</p>
<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><span class="type">GdkDevice</span> *device</code></em>,
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><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>,
@ -1053,36 +1053,36 @@ have this problem.</p>
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p> a <span class="type">GdkDevice</span>. </p></td>
<td class="parameter_description"><p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>parent_menu_shell</p></td>
<td class="parameter_description"><p> the menu shell containing the triggering
<td class="parameter_description"><p>the menu shell containing the triggering
menu item, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>parent_menu_item</p></td>
<td class="parameter_description"><p> the menu item whose activation triggered
<td class="parameter_description"><p>the menu item whose activation triggered
the popup, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> a user supplied function used to position the menu,
<td class="parameter_description"><p>a user supplied function used to position the menu,
or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p> user supplied data to be passed to <em class="parameter"><code>func</code></em>
<td class="parameter_description"><p>user supplied data to be passed to <em class="parameter"><code>func</code></em>
. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>destroy</p></td>
<td class="parameter_description"><p> destroy notify for <em class="parameter"><code>data</code></em>
<td class="parameter_description"><p>destroy notify for <em class="parameter"><code>data</code></em>
. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -1160,19 +1160,19 @@ have this problem.</p>
</tr>
<tr>
<td class="parameter_name"><p>parent_menu_shell</p></td>
<td class="parameter_description"><p> the menu shell containing the
<td class="parameter_description"><p>the menu shell containing the
triggering menu item, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>parent_menu_item</p></td>
<td class="parameter_description"><p> the menu item whose activation
<td class="parameter_description"><p>the menu item whose activation
triggered the popup, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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 class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> a user supplied function used to position
<td class="parameter_description"><p>a user supplied function used to position
the menu, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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>
@ -1223,7 +1223,7 @@ contained in this group.</p>
</tr>
<tr>
<td class="parameter_name"><p>accel_group</p></td>
<td class="parameter_description"><p> the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to be associated
<td class="parameter_description"><p>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to be associated
with the menu. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -1255,7 +1255,7 @@ menu. See <a class="link" href="GtkMenu.html#gtk-menu-set-accel-group" title="gt
</div>
<div class="refsect3">
<a name="gtk-menu-get-accel-group.returns"></a><h4>Returns</h4>
<p> the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> associated with the menu. </p>
<p>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> associated with the menu. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -1274,9 +1274,9 @@ Instead, by just calling <a class="link" href="GtkMenu.html#gtk-menu-set-accel-p
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>
<code class="literal">gtk_menu_set_accel_path (menu, "&amp;lt;Gnumeric-Sheet&gt;/File");</code> has been
called, assign its items the accel paths: <code class="literal">"&amp;lt;Gnumeric-Sheet&gt;/File/New"</code>
and <code class="literal">"&amp;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>
@ -1300,7 +1300,7 @@ it first with <code class="function">g_intern_static_string()</code>.</p>
</tr>
<tr>
<td class="parameter_name"><p>accel_path</p></td>
<td class="parameter_description"><p> a valid accelerator path, or <code class="literal">NULL</code> to unset the path. </p></td>
<td class="parameter_description"><p>a valid accelerator path, or <code class="literal">NULL</code> to unset the path. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@ -1363,7 +1363,7 @@ text as that menu item’s label.</p>
</tr>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p> a string containing the title for the menu, or <code class="literal">NULL</code> to
<td class="parameter_description"><p>a string containing the title for the menu, or <code class="literal">NULL</code> to
inherit the title of the parent menu item, if any. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
@ -1407,7 +1407,7 @@ and should not be modified or freed.</p>
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 <code class="function">gdk_monitor_get_geometry()</code>.</p>
See <a href="../html/GdkMonitor.html#gdk-monitor-get-geometry"><code class="function">gdk_monitor_get_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
@ -1472,7 +1472,7 @@ be popped up or -1, if no monitor has been set</p>
<a name="gtk-menu-place-on-monitor"></a><h3>gtk_menu_place_on_monitor ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_place_on_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">GdkMonitor</span> *monitor</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkMonitor.html#GdkMonitor-struct"><span class="type">GdkMonitor</span></a> *monitor</code></em>);</pre>
<p>Places <em class="parameter"><code>menu</code></em>
on the given monitor.</p>
<div class="refsect3">
@ -1655,7 +1655,7 @@ gtk_menu_get_active (<em class="parameter"><code><a class="link" href="GtkMenu.h
</div>
<div class="refsect3">
<a name="gtk-menu-get-active.returns"></a><h4>Returns</h4>
<p> the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that was last selected
<p>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. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@ -1762,7 +1762,7 @@ widgets moves between screens.</p>
</tr>
<tr>
<td class="parameter_name"><p>detacher</p></td>
<td class="parameter_description"><p> the user supplied callback function
<td class="parameter_description"><p>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>. </p></td>
<td class="parameter_annotations"><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>
@ -1818,7 +1818,7 @@ gtk_menu_get_attach_widget (<em class="parameter"><code><a class="link" href="Gt
</div>
<div class="refsect3">
<a name="gtk-menu-get-attach-widget.returns"></a><h4>Returns</h4>
<p> the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu is attached to. </p>
<p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that the menu is attached to. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -1846,7 +1846,7 @@ This list is owned by GTK+ and must not be modified.</p>
</div>
<div class="refsect3">
<a name="gtk-menu-get-for-attach-widget.returns"></a><h4>Returns</h4>
<p> the list
<p>the list
of menus attached to his widget. </p>
<p><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></p>
</div>
@ -1885,19 +1885,19 @@ called.</p>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p> address of the <span class="type">gint</span> representing the horizontal
<td class="parameter_description"><p>address of the <span class="type">gint</span> representing the horizontal
position where the menu shall be drawn. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p> address of the <span class="type">gint</span> representing the vertical position
<td class="parameter_description"><p>address of the <span class="type">gint</span> representing the vertical position
where the menu shall be drawn. This is an output parameter. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>push_in</p></td>
<td class="parameter_description"><p> This parameter controls how menus placed outside
<td class="parameter_description"><p>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
@ -2030,13 +2030,13 @@ menu item is selected.</p>
<hr>
<div class="refsect2">
<a name="GtkMenu--anchor-hints"></a><h3>The <code class="literal">“anchor-hints”</code> property</h3>
<pre class="programlisting"> “anchor-hints” <span class="type">GdkAnchorHints</span></pre>
<pre class="programlisting"> “anchor-hints” <a href="../html/gdk3-Windows.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></pre>
<p>Positioning hints for aligning the menu relative to a rectangle.</p>
<p>These hints determine how the menu should be positioned in the case that
the menu would fall off-screen if placed in its ideal position.</p>
<p><span class="inlinemediaobject"><img src="popup-flip.png"></span></p>
<p>For example, <code class="literal">GDK_ANCHOR_FLIP_Y</code> will replace <code class="literal">GDK_GRAVITY_NORTH_WEST</code> with
<code class="literal">GDK_GRAVITY_SOUTH_WEST</code> and vice versa if the menu extends beyond the
<p>For example, <a href="../html/gdk3-Windows.html#GDK-ANCHOR-FLIP-Y:CAPS"><code class="literal">GDK_ANCHOR_FLIP_Y</code></a> will replace <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></a> with
<a href="../html/gdk3-Windows.html#GDK-GRAVITY-SOUTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_SOUTH_WEST</code></a> and vice versa if the menu extends beyond the
bottom edge of the monitor.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-rect" title="gtk_menu_popup_at_rect ()"><code class="function">gtk_menu_popup_at_rect()</code></a>, <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a>,
<a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, <a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dx" title="The “rect-anchor-dx” property"><span class="type">“rect-anchor-dx”</span></a>,
@ -2058,8 +2058,8 @@ use <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_men
<hr>
<div class="refsect2">
<a name="GtkMenu--menu-type-hint"></a><h3>The <code class="literal">“menu-type-hint”</code> property</h3>
<pre class="programlisting"> “menu-type-hint” <span class="type">GdkWindowTypeHint</span></pre>
<p>The <span class="type">GdkWindowTypeHint</span> to use for the menu's <span class="type">GdkWindow</span>.</p>
<pre class="programlisting"> “menu-type-hint” <a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></pre>
<p>The <a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> to use for the menu's <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-rect" title="gtk_menu_popup_at_rect ()"><code class="function">gtk_menu_popup_at_rect()</code></a>, <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a>,
<a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, <a class="link" href="GtkMenu.html#GtkMenu--anchor-hints" title="The “anchor-hints” property"><span class="type">“anchor-hints”</span></a>,
<a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dx" title="The “rect-anchor-dx” property"><span class="type">“rect-anchor-dx”</span></a>, <a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dy" title="The “rect-anchor-dy” property"><span class="type">“rect-anchor-dy”</span></a>, and <a class="link" href="GtkMenu.html#GtkMenu-popped-up" title="The “popped-up” signal"><span class="type">“popped-up”</span></a>.</p>
@ -2355,14 +2355,14 @@ and the red menu is <em class="parameter"><code>final_rect</code></em>
</tr>
<tr>
<td class="parameter_name"><p>flipped_rect</p></td>
<td class="parameter_description"><p> the position of <em class="parameter"><code>menu</code></em>
<td class="parameter_description"><p>the position of <em class="parameter"><code>menu</code></em>
after any possible
flipping or <code class="literal">NULL</code> if the backend can't obtain it. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>final_rect</p></td>
<td class="parameter_description"><p> the final position of <em class="parameter"><code>menu</code></em>
<td class="parameter_description"><p>the final position of <em class="parameter"><code>menu</code></em>
or <code class="literal">NULL</code> if the
backend can't obtain it. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
@ -2391,6 +2391,6 @@ backend can't obtain it. </p></td>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>