~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
52
52
 
53
53
                    <a class="link" href="GtkToolButton.html#GtkToolButton-struct" title="GtkToolButton">GtkToolButton</a>;
54
54
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-new" title="gtk_tool_button_new ()">gtk_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>,
55
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
56
 
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-new-from-stock" title="gtk_tool_button_new_from_stock ()">gtk_tool_button_new_from_stock</a>      (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);
 
55
                                                         <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>);
 
56
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-new-from-stock" title="gtk_tool_button_new_from_stock ()">gtk_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>);
57
57
<span class="returnvalue">void</span>                <a class="link" href="GtkToolButton.html#gtk-tool-button-set-label" title="gtk_tool_button_set_label ()">gtk_tool_button_set_label</a>           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
58
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
59
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-label" title="gtk_tool_button_get_label ()">gtk_tool_button_get_label</a>           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
 
58
                                                         <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>);
 
59
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-label" title="gtk_tool_button_get_label ()">gtk_tool_button_get_label</a>           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
60
60
<span class="returnvalue">void</span>                <a class="link" href="GtkToolButton.html#gtk-tool-button-set-use-underline" title="gtk_tool_button_set_use_underline ()">gtk_tool_button_set_use_underline</a>   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
61
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);
62
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkToolButton.html#gtk-tool-button-get-use-underline" title="gtk_tool_button_get_use_underline ()">gtk_tool_button_get_use_underline</a>   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
 
61
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkToolButton.html#gtk-tool-button-get-use-underline" title="gtk_tool_button_get_use_underline ()">gtk_tool_button_get_use_underline</a>   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GtkToolButton.html#gtk-tool-button-set-stock-id" title="gtk_tool_button_set_stock_id ()">gtk_tool_button_set_stock_id</a>        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
64
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);
65
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-stock-id" title="gtk_tool_button_get_stock_id ()">gtk_tool_button_get_stock_id</a>        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
 
64
                                                         <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>);
 
65
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-stock-id" title="gtk_tool_button_get_stock_id ()">gtk_tool_button_get_stock_id</a>        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
66
66
<span class="returnvalue">void</span>                <a class="link" href="GtkToolButton.html#gtk-tool-button-set-icon-name" title="gtk_tool_button_set_icon_name ()">gtk_tool_button_set_icon_name</a>       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
67
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);
68
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-icon-name" title="gtk_tool_button_get_icon_name ()">gtk_tool_button_get_icon_name</a>       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
 
67
                                                         <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> *icon_name</code></em>);
 
68
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkToolButton.html#gtk-tool-button-get-icon-name" title="gtk_tool_button_get_icon_name ()">gtk_tool_button_get_icon_name</a>       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkToolButton.html#gtk-tool-button-set-icon-widget" title="gtk_tool_button_set_icon_widget ()">gtk_tool_button_set_icon_widget</a>     (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
70
70
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>);
71
71
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolButton.html#gtk-tool-button-get-icon-widget" title="gtk_tool_button_get_icon_widget ()">gtk_tool_button_get_icon_widget</a>     (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);
77
77
<div class="refsect1" title="Object Hierarchy">
78
78
<a name="GtkToolButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
79
79
<pre class="synopsis">
80
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
81
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
80
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
81
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
82
82
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
83
83
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
84
84
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
98
98
<div class="refsect1" title="Properties">
99
99
<a name="GtkToolButton.properties"></a><h2>Properties</h2>
100
100
<pre class="synopsis">
101
 
  "<a class="link" href="GtkToolButton.html#GtkToolButton--icon-name" title='The "icon-name" property'>icon-name</a>"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
101
  "<a class="link" href="GtkToolButton.html#GtkToolButton--icon-name" title='The "icon-name" property'>icon-name</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
102
102
  "<a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title='The "icon-widget" property'>icon-widget</a>"              <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
103
 
  "<a class="link" href="GtkToolButton.html#GtkToolButton--label" title='The "label" property'>label</a>"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
103
  "<a class="link" href="GtkToolButton.html#GtkToolButton--label" title='The "label" property'>label</a>"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
104
104
  "<a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title='The "label-widget" property'>label-widget</a>"             <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
105
 
  "<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title='The "stock-id" property'>stock-id</a>"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
106
 
  "<a class="link" href="GtkToolButton.html#GtkToolButton--use-underline" title='The "use-underline" property'>use-underline</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
105
  "<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title='The "stock-id" property'>stock-id</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
106
  "<a class="link" href="GtkToolButton.html#GtkToolButton--use-underline" title='The "use-underline" property'>use-underline</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
107
107
</pre>
108
108
</div>
109
109
<div class="refsect1" title="Style Properties">
110
110
<a name="GtkToolButton.style-properties"></a><h2>Style Properties</h2>
111
111
<pre class="synopsis">
112
 
  "<a class="link" href="GtkToolButton.html#GtkToolButton--s-icon-spacing" title='The "icon-spacing" style property'>icon-spacing</a>"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
112
  "<a class="link" href="GtkToolButton.html#GtkToolButton--s-icon-spacing" title='The "icon-spacing" style property'>icon-spacing</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
113
113
</pre>
114
114
</div>
115
115
<div class="refsect1" title="Signals">
131
131
<p>
132
132
The label of a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
133
133
"label-widget", "label", and "stock-id". If "label-widget" is
134
 
non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that widget is used as the label. Otherwise, if
135
 
"label" is non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, that string is used as the label. Otherwise, if
136
 
"stock-id" is non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label is determined by the stock
 
134
non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that widget is used as the label. Otherwise, if
 
135
"label" is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, that string is used as the label. Otherwise, if
 
136
"stock-id" is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label is determined by the stock
137
137
item. Otherwise, the button does not have a label.
138
138
</p>
139
139
<p>
140
140
The icon of a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
141
 
"icon-widget" and "stock-id". If "icon-widget" is non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
 
141
"icon-widget" and "stock-id". If "icon-widget" is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
142
142
that widget is used as the icon. Otherwise, if "stock-id" is
143
 
non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the icon is determined by the stock item. Otherwise,
 
143
non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the icon is determined by the stock item. Otherwise,
144
144
the button does not have a icon.
145
145
</p>
146
146
</div>
158
158
<div class="refsect2" title="gtk_tool_button_new ()">
159
159
<a name="gtk-tool-button-new"></a><h3>gtk_tool_button_new ()</h3>
160
160
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
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>
162
162
<p>
163
163
Creates a new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><code class="literal">GtkToolButton</code></a> using <em class="parameter"><code>icon_widget</code></em> as icon and <em class="parameter"><code>label</code></em> as
164
164
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 <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> widget that will be used as icon widget, or <a href="/usr/share/gtk-doc/html/glib/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 <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></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>
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="/usr/share/gtk-doc/html/glib/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="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>
177
177
</td>
178
178
</tr>
179
179
<tr>
189
189
<hr>
190
190
<div class="refsect2" title="gtk_tool_button_new_from_stock ()">
191
191
<a name="gtk-tool-button-new-from-stock"></a><h3>gtk_tool_button_new_from_stock ()</h3>
192
 
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_tool_button_new_from_stock      (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
 
192
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_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>
193
193
<p>
194
194
Creates a new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> containing the image and text from a
195
195
stock item. Some stock ids have preprocessor macros like <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><span class="type">GTK_STOCK_OK</span></a>
220
220
<div class="refsect2" title="gtk_tool_button_set_label ()">
221
221
<a name="gtk-tool-button-set-label"></a><h3>gtk_tool_button_set_label ()</h3>
222
222
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tool_button_set_label           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
223
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
223
                                                         <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>
224
224
<p>
225
225
Sets <em class="parameter"><code>label</code></em> as the label used for the tool button. The "label" property
226
 
only has an effect if not overridden by a non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label_widget" property.
227
 
If both the "label_widget" and "label" properties are <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label
 
226
only has an effect if not overridden by a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label_widget" property.
 
227
If both the "label_widget" and "label" properties are <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label
228
228
is determined by the "stock_id" property. If the "stock_id" property is also
229
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have a label.
 
229
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have a label.
230
230
</p>
231
231
<div class="variablelist"><table border="0">
232
232
<col align="left" valign="top">
238
238
</tr>
239
239
<tr>
240
240
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
241
 
<td> a string that will be used as label, or <a href="/usr/share/gtk-doc/html/glib/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>
 
241
<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>
242
242
</td>
243
243
</tr>
244
244
</tbody>
248
248
<hr>
249
249
<div class="refsect2" title="gtk_tool_button_get_label ()">
250
250
<a name="gtk-tool-button-get-label"></a><h3>gtk_tool_button_get_label ()</h3>
251
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_label           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
 
251
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_label           (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
252
252
<p>
253
 
Returns the label used by the tool button, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button
 
253
Returns the label used by the tool button, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button
254
254
doesn't have a label. or uses a the label from a stock item. The returned
255
255
string is owned by GTK+, and must not be modified or freed.
256
256
</p>
264
264
</tr>
265
265
<tr>
266
266
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
267
 
<td> The label, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
267
<td> The label, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
268
268
 
269
269
</td>
270
270
</tr>
276
276
<div class="refsect2" title="gtk_tool_button_set_use_underline ()">
277
277
<a name="gtk-tool-button-set-use-underline"></a><h3>gtk_tool_button_set_use_underline ()</h3>
278
278
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tool_button_set_use_underline   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
279
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);</pre>
 
279
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);</pre>
280
280
<p>
281
281
If set, an underline in the label property indicates that the next character
282
282
should be used for the mnemonic accelerator key in the overflow menu. For
283
 
example, if the label property is "_Open" and <em class="parameter"><code>use_underline</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
 
283
example, if the label property is "_Open" and <em class="parameter"><code>use_underline</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
284
284
the label on the tool button will be "Open" and the item on the overflow
285
285
menu will have an underlined 'O'.
286
286
</p>
308
308
<hr>
309
309
<div class="refsect2" title="gtk_tool_button_get_use_underline ()">
310
310
<a name="gtk-tool-button-get-use-underline"></a><h3>gtk_tool_button_get_use_underline ()</h3>
311
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_tool_button_get_use_underline   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
 
311
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_tool_button_get_use_underline   (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
312
312
<p>
313
313
Returns whether underscores in the label property are used as mnemonics
314
314
on menu items on the overflow menu. See <a class="link" href="GtkToolButton.html#gtk-tool-button-set-use-underline" title="gtk_tool_button_set_use_underline ()"><code class="function">gtk_tool_button_set_use_underline()</code></a>.
323
323
</tr>
324
324
<tr>
325
325
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
326
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underscores in the label property are used as
 
326
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underscores in the label property are used as
327
327
mnemonics on menu items on the overflow menu.
328
328
 
329
329
</td>
336
336
<div class="refsect2" title="gtk_tool_button_set_stock_id ()">
337
337
<a name="gtk-tool-button-set-stock-id"></a><h3>gtk_tool_button_set_stock_id ()</h3>
338
338
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tool_button_set_stock_id        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
339
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
 
339
                                                         <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>
340
340
<p>
341
341
Sets the name of the stock item. See <a class="link" href="GtkToolButton.html#gtk-tool-button-new-from-stock" title="gtk_tool_button_new_from_stock ()"><code class="function">gtk_tool_button_new_from_stock()</code></a>.
342
342
The stock_id property only has an effect if not
343
 
overridden by non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label" and "icon_widget" properties.
 
343
overridden by non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label" and "icon_widget" properties.
344
344
</p>
345
345
<div class="variablelist"><table border="0">
346
346
<col align="left" valign="top">
352
352
</tr>
353
353
<tr>
354
354
<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
355
 
<td> a name of a stock item, or <a href="/usr/share/gtk-doc/html/glib/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>
 
355
<td> a name of a stock item, 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>
356
356
</td>
357
357
</tr>
358
358
</tbody>
362
362
<hr>
363
363
<div class="refsect2" title="gtk_tool_button_get_stock_id ()">
364
364
<a name="gtk-tool-button-get-stock-id"></a><h3>gtk_tool_button_get_stock_id ()</h3>
365
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_stock_id        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
 
365
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_stock_id        (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
366
366
<p>
367
367
Returns the name of the stock item. See <a class="link" href="GtkToolButton.html#gtk-tool-button-set-stock-id" title="gtk_tool_button_set_stock_id ()"><code class="function">gtk_tool_button_set_stock_id()</code></a>.
368
368
The returned string is owned by GTK+ and must not be freed or modifed.
389
389
<div class="refsect2" title="gtk_tool_button_set_icon_name ()">
390
390
<a name="gtk-tool-button-set-icon-name"></a><h3>gtk_tool_button_set_icon_name ()</h3>
391
391
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tool_button_set_icon_name       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>,
392
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
 
392
                                                         <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> *icon_name</code></em>);</pre>
393
393
<p>
394
394
Sets the icon for the tool button from a named themed icon.
395
395
See the docs for <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.
396
396
The "icon_name" property only has an effect if not
397
 
overridden by non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label", "icon_widget" and "stock_id"
 
397
overridden by non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> "label", "icon_widget" and "stock_id"
398
398
properties.
399
399
</p>
400
400
<div class="variablelist"><table border="0">
417
417
<hr>
418
418
<div class="refsect2" title="gtk_tool_button_get_icon_name ()">
419
419
<a name="gtk-tool-button-get-icon-name"></a><h3>gtk_tool_button_get_icon_name ()</h3>
420
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_icon_name       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
 
420
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_tool_button_get_icon_name       (<em class="parameter"><code><a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *button</code></em>);</pre>
421
421
<p>
422
422
Returns the name of the themed icon for the tool button,
423
423
see <a class="link" href="GtkToolButton.html#gtk-tool-button-set-icon-name" title="gtk_tool_button_set_icon_name ()"><code class="function">gtk_tool_button_set_icon_name()</code></a>.
432
432
</tr>
433
433
<tr>
434
434
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
435
 
<td> the icon name or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button has
 
435
<td> the icon name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button has
436
436
no themed icon
437
437
 
438
438
</td>
448
448
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>);</pre>
449
449
<p>
450
450
Sets <em class="parameter"><code>icon</code></em> as the widget used as icon on <em class="parameter"><code>button</code></em>. If <em class="parameter"><code>icon_widget</code></em> is
451
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the icon is determined by the "stock_id" property. If the
452
 
"stock_id" property is also <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have an icon.
 
451
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the icon is determined by the "stock_id" property. If the
 
452
"stock_id" property is also <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have an icon.
453
453
</p>
454
454
<div class="variablelist"><table border="0">
455
455
<col align="left" valign="top">
461
461
</tr>
462
462
<tr>
463
463
<td><p><span class="term"><em class="parameter"><code>icon_widget</code></em> :</span></p></td>
464
 
<td> the widget used as icon, or <a href="/usr/share/gtk-doc/html/glib/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>
 
464
<td> the widget used as icon, 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>
465
465
</td>
466
466
</tr>
467
467
</tbody>
486
486
</tr>
487
487
<tr>
488
488
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
489
 
<td> The widget used as icon on <em class="parameter"><code>button</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
489
<td> The widget used as icon on <em class="parameter"><code>button</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
490
490
 
491
491
</td>
492
492
</tr>
501
501
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *label_widget</code></em>);</pre>
502
502
<p>
503
503
Sets <em class="parameter"><code>label_widget</code></em> as the widget that will be used as the label
504
 
for <em class="parameter"><code>button</code></em>. If <em class="parameter"><code>label_widget</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the "label" property is used
505
 
as label. If "label" is also <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label in the stock item
 
504
for <em class="parameter"><code>button</code></em>. If <em class="parameter"><code>label_widget</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the "label" property is used
 
505
as label. If "label" is also <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label in the stock item
506
506
determined by the "stock_id" property is used as label. If
507
 
"stock_id" is also <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> does not have a label.
 
507
"stock_id" is also <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> does not have a label.
508
508
</p>
509
509
<div class="variablelist"><table border="0">
510
510
<col align="left" valign="top">
516
516
</tr>
517
517
<tr>
518
518
<td><p><span class="term"><em class="parameter"><code>label_widget</code></em> :</span></p></td>
519
 
<td> the widget used as label, or <a href="/usr/share/gtk-doc/html/glib/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>
 
519
<td> the widget 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>
520
520
</td>
521
521
</tr>
522
522
</tbody>
541
541
</tr>
542
542
<tr>
543
543
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
544
 
<td> The widget used as label on <em class="parameter"><code>button</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
544
<td> The widget used as label on <em class="parameter"><code>button</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
545
545
 
546
546
</td>
547
547
</tr>
554
554
<a name="GtkToolButton.property-details"></a><h2>Property Details</h2>
555
555
<div class="refsect2" title='The "icon-name" property'>
556
556
<a name="GtkToolButton--icon-name"></a><h3>The <code class="literal">"icon-name"</code> property</h3>
557
 
<pre class="programlisting">  "icon-name"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
557
<pre class="programlisting">  "icon-name"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
558
558
<p>
559
559
The name of the themed icon displayed on the item.
560
560
This property only has an effect if not overridden by "label",
572
572
<hr>
573
573
<div class="refsect2" title='The "label" property'>
574
574
<a name="GtkToolButton--label"></a><h3>The <code class="literal">"label"</code> property</h3>
575
 
<pre class="programlisting">  "label"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
575
<pre class="programlisting">  "label"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
576
576
<p>Text to show in the item.</p>
577
577
<p>Default value: NULL</p>
578
578
</div>
585
585
<hr>
586
586
<div class="refsect2" title='The "stock-id" property'>
587
587
<a name="GtkToolButton--stock-id"></a><h3>The <code class="literal">"stock-id"</code> property</h3>
588
 
<pre class="programlisting">  "stock-id"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
588
<pre class="programlisting">  "stock-id"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
589
589
<p>The stock icon displayed on the item.</p>
590
590
<p>Default value: NULL</p>
591
591
</div>
592
592
<hr>
593
593
<div class="refsect2" title='The "use-underline" property'>
594
594
<a name="GtkToolButton--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>
595
 
<pre class="programlisting">  "use-underline"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
595
<pre class="programlisting">  "use-underline"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
596
596
<p>If set, an underline in the label property indicates that the next character should be used for the mnemonic accelerator key in the overflow menu.</p>
597
597
<p>Default value: FALSE</p>
598
598
</div>
601
601
<a name="GtkToolButton.style-property-details"></a><h2>Style Property Details</h2>
602
602
<div class="refsect2" title='The "icon-spacing" style property'>
603
603
<a name="GtkToolButton--s-icon-spacing"></a><h3>The <code class="literal">"icon-spacing"</code> style property</h3>
604
 
<pre class="programlisting">  "icon-spacing"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
604
<pre class="programlisting">  "icon-spacing"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
605
605
<p>Spacing in pixels between the icon and label.</p>
606
606
<p>Allowed values: &gt;= 0</p>
607
607
<p>Default value: 3</p>
612
612
<div class="refsect2" title='The "clicked" signal'>
613
613
<a name="GtkToolButton-clicked"></a><h3>The <code class="literal">"clicked"</code> signal</h3>
614
614
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> *toolbutton,
615
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)       : Run First / Action</pre>
 
615
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)       : Run First / Action</pre>
616
616
<p>
617
617
This signal is emitted when the tool button is clicked with the mouse
618
618
or activated with the keyboard.