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
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
115
115
<div class="refsect1" title="Signals">
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.
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.
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>
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
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>
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>
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>
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>
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.
231
231
<div class="variablelist"><table border="0">
232
232
<col align="left" valign="top">
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>
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.
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>
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'.
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>
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>.
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>
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.
345
345
<div class="variablelist"><table border="0">
346
346
<col align="left" valign="top">
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>
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>
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"
400
400
<div class="variablelist"><table border="0">
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>
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>.
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>
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.
454
454
<div class="variablelist"><table border="0">
455
455
<col align="left" valign="top">
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>
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.
509
509
<div class="variablelist"><table border="0">
510
510
<col align="left" valign="top">
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>
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",
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>
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>
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: >= 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>
617
617
This signal is emitted when the tool button is clicked with the mouse
618
618
or activated with the keyboard.