8
8
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
9
9
<link rel="prev" href="GtkToolButton.html" title="GtkToolButton">
10
10
<link rel="next" href="GtkToggleToolButton.html" title="GtkToggleToolButton">
11
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
51
51
struct <a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton-struct" title="struct GtkMenuToolButton">GtkMenuToolButton</a>;
52
52
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new" title="gtk_menu_tool_button_new ()">gtk_menu_tool_button_new</a> (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>,
53
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
54
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new-from-stock" title="gtk_menu_tool_button_new_from_stock ()">gtk_menu_tool_button_new_from_stock</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);
53
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
54
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new-from-stock" title="gtk_menu_tool_button_new_from_stock ()">gtk_menu_tool_button_new_from_stock</a> (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);
55
55
<span class="returnvalue">void</span> <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-menu" title="gtk_menu_tool_button_set_menu ()">gtk_menu_tool_button_set_menu</a> (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
56
56
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu</code></em>);
57
57
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-get-menu" title="gtk_menu_tool_button_get_menu ()">gtk_menu_tool_button_get_menu</a> (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>);
58
58
<span class="returnvalue">void</span> <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip" title="gtk_menu_tool_button_set_arrow_tooltip ()">gtk_menu_tool_button_set_arrow_tooltip</a>
59
59
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
60
60
<em class="parameter"><code><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> *tooltips</code></em>,
61
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tip_text</code></em>,
62
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tip_private</code></em>);
61
<em class="parameter"><code>const <span class="type">gchar</span> *tip_text</code></em>,
62
<em class="parameter"><code>const <span class="type">gchar</span> *tip_private</code></em>);
63
63
<span class="returnvalue">void</span> <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip-text" title="gtk_menu_tool_button_set_arrow_tooltip_text ()">gtk_menu_tool_button_set_arrow_tooltip_text</a>
64
64
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
65
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);
65
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);
66
66
<span class="returnvalue">void</span> <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip-markup" title="gtk_menu_tool_button_set_arrow_tooltip_markup ()">gtk_menu_tool_button_set_arrow_tooltip_markup</a>
67
67
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
68
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);
68
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);
71
71
<div class="refsect1">
72
72
<a name="GtkMenuToolButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
73
73
<pre class="synopsis">
74
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
75
+----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
75
+----GInitiallyUnowned
76
76
+----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
77
77
+----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
78
78
+----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
158
158
<div class="refsect2">
159
159
<a name="gtk-menu-tool-button-new"></a><h3>gtk_menu_tool_button_new ()</h3>
160
160
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * gtk_menu_tool_button_new (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>,
161
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
161
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
163
163
Creates a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> using <em class="parameter"><code>icon_widget</code></em> as icon and
164
164
<em class="parameter"><code>label</code></em> as label.
173
173
<td><p><span class="term"><em class="parameter"><code>icon_widget</code></em> :</span></p></td>
174
<td>a widget that will be used as icon widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
174
<td>a widget that will be used as icon widget, or <a href="/usr/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>
178
178
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
179
<td>a string that will be used as label, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
179
<td>a string that will be used as label, or <a href="/usr/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>
192
192
<div class="refsect2">
193
193
<a name="gtk-menu-tool-button-new-from-stock"></a><h3>gtk_menu_tool_button_new_from_stock ()</h3>
194
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * gtk_menu_tool_button_new_from_stock (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
194
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> * gtk_menu_tool_button_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
196
196
Creates a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
197
197
The new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> will contain an icon and label from
279
279
<pre class="programlisting"><span class="returnvalue">void</span> gtk_menu_tool_button_set_arrow_tooltip
280
280
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
281
281
<em class="parameter"><code><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> *tooltips</code></em>,
282
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tip_text</code></em>,
283
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tip_private</code></em>);</pre>
282
<em class="parameter"><code>const <span class="type">gchar</span> *tip_text</code></em>,
283
<em class="parameter"><code>const <span class="type">gchar</span> *tip_private</code></em>);</pre>
284
284
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
285
285
<h3 class="title">Warning</h3>
286
286
<p><code class="literal">gtk_menu_tool_button_set_arrow_tooltip</code> has been deprecated since version 2.12 and should not be used in newly-written code. Use <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip-text" title="gtk_menu_tool_button_set_arrow_tooltip_text ()"><code class="function">gtk_menu_tool_button_set_arrow_tooltip_text()</code></a>
325
325
<a name="gtk-menu-tool-button-set-arrow-tooltip-text"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_text ()</h3>
326
326
<pre class="programlisting"><span class="returnvalue">void</span> gtk_menu_tool_button_set_arrow_tooltip_text
327
327
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
328
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
328
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
330
330
Sets the tooltip text to be used as tooltip for the arrow button which
331
331
pops up the menu. See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip" title="gtk_tool_item_set_tooltip ()"><code class="function">gtk_tool_item_set_tooltip()</code></a> for setting a tooltip
355
355
<a name="gtk-menu-tool-button-set-arrow-tooltip-markup"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_markup ()</h3>
356
356
<pre class="programlisting"><span class="returnvalue">void</span> gtk_menu_tool_button_set_arrow_tooltip_markup
357
357
(<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
358
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
358
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
360
360
Sets the tooltip markup text to be used as tooltip for the arrow button
361
361
which pops up the menu. See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip" title="gtk_tool_item_set_tooltip ()"><code class="function">gtk_tool_item_set_tooltip()</code></a> for setting a
394
394
<div class="refsect2">
395
395
<a name="GtkMenuToolButton-show-menu"></a><h3>The <code class="literal">"show-menu"</code> signal</h3>
396
396
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button,
397
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
397
<span class="type">gpointer</span> user_data) : <code class="literal">Run First</code></pre>
399
399
The ::show-menu signal is emitted before the menu is shown.