← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkMenuToolButton.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2011-09-08 20:30:15 UTC
  • mfrom: (1.14.10 upstream)
  • Revision ID: package-import@ubuntu.com-20110908203015-hmdoq5jt1bl50nq3
Tags: 2.24.6-0ubuntu1
* debian/watch: Look for bz2 tarballs, and restrict to GTK 2 versions.
* New upstream bug fix release.
* Drop 094_git_fileselector_error.patch, include_m4_dir.patch: Included
  upstream.
* 003_gdk.pc_privates.patch, 009_gtk-export-filechooser.patch: Unfuzz.
* debian/libgail-doc.install, debian/libgtk2.0-doc.install.in: Install
  documentation from the source tree, as it's not being installed any more.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkMenuToolButton.html
50
50
 
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>);
69
69
</pre>
70
70
</div>
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>
 
74
  GObject
 
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>
97
97
<div class="refsect1">
98
98
<a name="GtkMenuToolButton.signals"></a><h2>Signals</h2>
99
99
<pre class="synopsis">
100
 
  "<a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton-show-menu" title='The "show-menu" signal'>show-menu</a>"                                      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
 
100
  "<a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton-show-menu" title='The "show-menu" signal'>show-menu</a>"                                      : <code class="literal">Run First</code>
101
101
</pre>
102
102
</div>
103
103
<div class="refsect1">
120
120
attribute of a &lt;child&gt; element.
121
121
</p>
122
122
<div class="example">
123
 
<a name="id982334"></a><p class="title"><b>Example 35. A UI definition fragment with menus</b></p>
 
123
<a name="id1034811"></a><p class="title"><b>Example 35. A UI definition fragment with menus</b></p>
124
124
<div class="example-contents">
125
125
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
126
126
    <tbody>
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>
162
162
<p>
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.
168
168
<tbody>
169
169
<tr>
170
170
<td><p><span class="term"><em class="parameter"><code>icon_widget</code></em> :</span></p></td>
171
 
<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>
 
171
<td>a widget that will be used as icon widget, 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>
172
172
</td>
173
173
</tr>
174
174
<tr>
175
175
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
176
 
<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>
 
176
<td>a string that will be used as label, 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>
177
177
</td>
178
178
</tr>
179
179
<tr>
188
188
<hr>
189
189
<div class="refsect2">
190
190
<a name="gtk-menu-tool-button-new-from-stock"></a><h3>gtk_menu_tool_button_new_from_stock ()</h3>
191
 
<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>
 
191
<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>
192
192
<p>
193
193
Creates a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
194
194
The new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> will contain an icon and label from
267
267
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_arrow_tooltip
268
268
                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
269
269
                                                         <em class="parameter"><code><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> *tooltips</code></em>,
270
 
                                                         <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>,
271
 
                                                         <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>
 
270
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *tip_text</code></em>,
 
271
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *tip_private</code></em>);</pre>
272
272
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
273
273
<h3 class="title">Warning</h3>
274
274
<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>
310
310
<a name="gtk-menu-tool-button-set-arrow-tooltip-text"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_text ()</h3>
311
311
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_arrow_tooltip_text
312
312
                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
313
 
                                                         <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>
 
313
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
314
314
<p>
315
315
Sets the tooltip text to be used as tooltip for the arrow button which
316
316
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
337
337
<a name="gtk-menu-tool-button-set-arrow-tooltip-markup"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_markup ()</h3>
338
338
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_arrow_tooltip_markup
339
339
                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
340
 
                                                         <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>
 
340
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
341
341
<p>
342
342
Sets the tooltip markup text to be used as tooltip for the arrow button
343
343
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
373
373
<div class="refsect2">
374
374
<a name="GtkMenuToolButton-show-menu"></a><h3>The <code class="literal">"show-menu"</code> signal</h3>
375
375
<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,
376
 
                                                        <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>
 
376
                                                        <span class="type">gpointer</span>           user_data)      : <code class="literal">Run First</code></pre>
377
377
<p>
378
378
The ::show-menu signal is emitted before the menu is shown.
379
379
</p>