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

New upstream version 3.24.5

Browse Source
This commit is contained in:
Jeremy Bicha
2019-02-04 16:36:47 -05:00
parent 79399d953a bf60bf15de
commit ac00df30b2
512 changed files with 389739 additions and 466248 deletions
Download Patch File Download Diff File Expand all files Collapse all files

116
docs/reference/gtk/html/GtkToolButton.html
View File

@ -69,7 +69,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkToolButton.html#gtk-tool-button-get-label" title="gtk_tool_button_get_label ()">gtk_tool_button_get_label</a> <span class="c_punctuation">()</span>
@ -85,7 +85,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
@ -100,7 +100,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
@ -115,7 +115,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
@ -167,7 +167,7 @@
<tbody>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GtkToolButton.html#GtkToolButton--icon-name" title="The “icon-name” property">icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -179,7 +179,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property">label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -191,12 +191,12 @@
</tr>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property">stock-id</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GtkToolButton.html#GtkToolButton--use-underline" title="The “use-underline” property">use-underline</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -212,7 +212,7 @@
<col width="200px" class="style_properties_flags">
</colgroup>
<tbody><tr>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkToolButton.html#GtkToolButton--s-icon-spacing" title="The “icon-spacing” style property">icon-spacing</a></td>
<td class="property_flags">Read / Write</td>
</tr></tbody>
@ -229,7 +229,7 @@
<tbody><tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkToolButton.html#GtkToolButton-clicked" title="The “clicked” signal">clicked</a></td>
<td class="signal_flags">Action</td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr></tbody>
</table></div>
</div>
@ -254,8 +254,8 @@
</div>
<div class="refsect1">
<a name="GtkToolButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
@ -283,15 +283,15 @@ GtkToolButton implements
<p>The label of a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
<a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a>, <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a>, and
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>. If <a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a> is
non-<code class="literal">NULL</code>, then that widget is used as the label. Otherwise, if
<a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> is non-<code class="literal">NULL</code>, that string is used as the label.
Otherwise, if <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> is non-<code class="literal">NULL</code>, the label is
non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that widget is used as the label. Otherwise, if
<a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, that string is used as the label.
Otherwise, if <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label is
determined by the stock item. Otherwise, the button does not have a label.</p>
<p>The icon of a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
<a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> and <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>. If
<a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> is non-<code class="literal">NULL</code>, then
<a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
that widget is used as the icon. Otherwise, if <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> is
non-<code class="literal">NULL</code>, the icon is determined by the stock item. Otherwise,
non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the icon is determined by the stock item. Otherwise,
the button does not have a icon.</p>
<div class="refsect2">
<a name="id-1.3.13.16.11.6"></a><h3>CSS nodes</h3>
@ -304,7 +304,7 @@ the button does not have a icon.</p>
<a name="gtk-tool-button-new"></a><h3>gtk_tool_button_new ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> using <em class="parameter"><code>icon_widget</code></em>
as contents and <em class="parameter"><code>label</code></em>
as
@ -320,12 +320,12 @@ label.</p>
<tbody>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>a string that will be used as label, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a string that will be used as label, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>icon_widget</p></td>
<td class="parameter_description"><p>a widget that will be used as the button contents, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a widget that will be used as the button contents, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -341,7 +341,7 @@ label.</p>
<div class="refsect2">
<a name="gtk-tool-button-new-from-stock"></a><h3>gtk_tool_button_new_from_stock ()</h3>
<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 <span class="type">gchar</span> *stock_id</code></em>);</pre>
gtk_tool_button_new_from_stock (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_tool_button_new_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkToolButton.html#gtk-tool-button-new" title="gtk_tool_button_new ()"><code class="function">gtk_tool_button_new()</code></a> together with
@ -378,14 +378,14 @@ and <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-APPLY:CAPS" title="GTK
<a name="gtk-tool-button-set-label"></a><h3>gtk_tool_button_set_label ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
<p>Sets <em class="parameter"><code>label</code></em>
as the label used for the tool button. The <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a>
property only has an effect if not overridden by a non-<code class="literal">NULL</code>
property only has an effect if not overridden by a non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
<a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a> property. If both the <a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a>
and <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> properties are <code class="literal">NULL</code>, the label is determined by the
and <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> properties are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label is determined by the
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property. If the <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property is
also <code class="literal">NULL</code>, <em class="parameter"><code>button</code></em>
also <a href="https://developer.gnome.org/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.</p>
<div class="refsect3">
<a name="gtk-tool-button-set-label.parameters"></a><h4>Parameters</h4>
@ -403,7 +403,7 @@ also <code class="literal">NULL</code>, <em class="parameter"><code>button</code
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>a string that will be used as label, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a string that will be used as label, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -414,9 +414,9 @@ also <code class="literal">NULL</code>, <em class="parameter"><code>button</code
<hr>
<div class="refsect2">
<a name="gtk-tool-button-get-label"></a><h3>gtk_tool_button_get_label ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
<pre class="programlisting">const <a href="https://developer.gnome.org/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>
<p>Returns the label used by the tool button, or <code class="literal">NULL</code> if the tool button
<p>Returns the label used by the tool button, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button
doesn’t have a label. or uses a the label from a stock item. The returned
string is owned by GTK+, and must not be modified or freed.</p>
<div class="refsect3">
@ -436,7 +436,7 @@ string is owned by GTK+, and must not be modified or freed.</p>
</div>
<div class="refsect3">
<a name="gtk-tool-button-get-label.returns"></a><h4>Returns</h4>
<p>The label, or <code class="literal">NULL</code>. </p>
<p>The label, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
@ -446,11 +446,11 @@ string is owned by GTK+, and must not be modified or freed.</p>
<a name="gtk-tool-button-set-use-underline"></a><h3>gtk_tool_button_set_use_underline ()</h3>
<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>,
<em class="parameter"><code><span class="type">gboolean</span> use_underline</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);</pre>
<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. For
example, if the label property is “_Open” and <em class="parameter"><code>use_underline</code></em>
is <code class="literal">TRUE</code>,
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
the label on the tool button will be “Open” and the item on the overflow
menu will have an underlined “O”.</p>
<p>Labels shown on tool buttons never have mnemonics on them; this property
@ -482,7 +482,7 @@ only affects the menu item on the overflow menu.</p>
<hr>
<div class="refsect2">
<a name="gtk-tool-button-get-use-underline"></a><h3>gtk_tool_button_get_use_underline ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/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>
<p>Returns whether underscores in the label property are used as mnemonics
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>.</p>
@ -503,7 +503,7 @@ on menu items on the overflow menu. See <a class="link" href="GtkToolButton.html
</div>
<div class="refsect3">
<a name="gtk-tool-button-get-use-underline.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if underscores in the label property are used as
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underscores in the label property are used as
mnemonics on menu items on the overflow menu.</p>
</div>
<p class="since">Since: 2.4</p>
@ -513,13 +513,13 @@ mnemonics on menu items on the overflow menu.</p>
<a name="gtk-tool-button-set-stock-id"></a><h3>gtk_tool_button_set_stock_id ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_tool_button_set_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <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> instead.</p>
</div>
<p>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>.
The stock_id property only has an effect if not overridden by non-<code class="literal">NULL</code>
The stock_id property only has an effect if not overridden by non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
<a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a> and <a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> properties.</p>
<div class="refsect3">
<a name="gtk-tool-button-set-stock-id.parameters"></a><h4>Parameters</h4>
@ -537,7 +537,7 @@ The stock_id property only has an effect if not overridden by non-<code class="l
</tr>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p>a name of a stock item, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a name of a stock item, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -548,7 +548,7 @@ The stock_id property only has an effect if not overridden by non-<code class="l
<hr>
<div class="refsect2">
<a name="gtk-tool-button-get-stock-id"></a><h3>gtk_tool_button_get_stock_id ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
<pre class="programlisting">const <a href="https://developer.gnome.org/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>
<div class="warning">
<p><code class="literal">gtk_tool_button_get_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -583,11 +583,11 @@ The returned string is owned by GTK+ and must not be freed or modifed.</p>
<a name="gtk-tool-button-set-icon-name"></a><h3>gtk_tool_button_set_icon_name ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
<p>Sets the icon for the tool button from a named themed icon.
See the docs for <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.
The <a class="link" href="GtkToolButton.html#GtkToolButton--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a> property only has an effect if not
overridden by non-<code class="literal">NULL</code> <a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a>,
overridden by non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a>,
<a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> and <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> properties.</p>
<div class="refsect3">
<a name="gtk-tool-button-set-icon-name.parameters"></a><h4>Parameters</h4>
@ -616,7 +616,7 @@ overridden by non-<code class="literal">NULL</code> <a class="link" href="GtkToo
<hr>
<div class="refsect2">
<a name="gtk-tool-button-get-icon-name"></a><h3>gtk_tool_button_get_icon_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
<pre class="programlisting">const <a href="https://developer.gnome.org/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>
<p>Returns the name of the themed icon for the tool button,
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>.</p>
@ -637,7 +637,7 @@ see <a class="link" href="GtkToolButton.html#gtk-tool-button-set-icon-name" titl
</div>
<div class="refsect3">
<a name="gtk-tool-button-get-icon-name.returns"></a><h4>Returns</h4>
<p>the icon name or <code class="literal">NULL</code> if the tool button has
<p>the icon name or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tool button has
no themed icon. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
@ -653,8 +653,8 @@ gtk_tool_button_set_icon_widget (<em class="parameter"><code><a class="link" hre
as the widget used as icon on <em class="parameter"><code>button</code></em>
. If <em class="parameter"><code>icon_widget</code></em>
is
<code class="literal">NULL</code> the icon is determined by the <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property. If the
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property is also <code class="literal">NULL</code>, <em class="parameter"><code>button</code></em>
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the icon is determined by the <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property. If the
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property is also <a href="https://developer.gnome.org/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.</p>
<div class="refsect3">
<a name="gtk-tool-button-set-icon-widget.parameters"></a><h4>Parameters</h4>
@ -672,7 +672,7 @@ gtk_tool_button_set_icon_widget (<em class="parameter"><code><a class="link" hre
</tr>
<tr>
<td class="parameter_name"><p>icon_widget</p></td>
<td class="parameter_description"><p>the widget used as icon, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>the widget used as icon, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -707,7 +707,7 @@ See <a class="link" href="GtkToolButton.html#gtk-tool-button-set-icon-widget" ti
<a name="gtk-tool-button-get-icon-widget.returns"></a><h4>Returns</h4>
<p>The widget used as icon
on <em class="parameter"><code>button</code></em>
, or <code class="literal">NULL</code>. </p>
, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
@ -722,10 +722,10 @@ gtk_tool_button_set_label_widget (<em class="parameter"><code><a class="link" hr
as the widget that will be used as the label
for <em class="parameter"><code>button</code></em>
. If <em class="parameter"><code>label_widget</code></em>
is <code class="literal">NULL</code> the <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> property is used
as label. If <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> is also <code class="literal">NULL</code>, the label in the stock item
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> property is used
as label. If <a class="link" href="GtkToolButton.html#GtkToolButton--label" title="The “label” property"><span class="type">“label”</span></a> is also <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label in the stock item
determined by the <a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> property is used as label. If
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> is also <code class="literal">NULL</code>, <em class="parameter"><code>button</code></em>
<a class="link" href="GtkToolButton.html#GtkToolButton--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> is also <a href="https://developer.gnome.org/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.</p>
<div class="refsect3">
<a name="gtk-tool-button-set-label-widget.parameters"></a><h4>Parameters</h4>
@ -743,7 +743,7 @@ determined by the <a class="link" href="GtkToolButton.html#GtkToolButton--stock-
</tr>
<tr>
<td class="parameter_name"><p>label_widget</p></td>
<td class="parameter_description"><p>the widget used as label, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>the widget used as label, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -778,7 +778,7 @@ See <a class="link" href="GtkToolButton.html#gtk-tool-button-set-label-widget" t
<a name="gtk-tool-button-get-label-widget.returns"></a><h4>Returns</h4>
<p>The widget used as label
on <em class="parameter"><code>button</code></em>
, or <code class="literal">NULL</code>. </p>
, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
@ -813,7 +813,7 @@ on <em class="parameter"><code>button</code></em>
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">GType</span> <em class="structfield"><code><a name="GtkToolButtonClass.button-type"></a>button_type</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GtkToolButtonClass.button-type"></a>button_type</code></em>;</p></td>
<td class="struct_member_description"> </td>
<td class="struct_member_annotations"> </td>
</tr>
@ -832,7 +832,7 @@ mouse or activated with the keyboard.</p></td>
<a name="GtkToolButton.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkToolButton--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
<pre class="programlisting"> “icon-name” <span class="type">gchar</span> *</pre>
<pre class="programlisting"> “icon-name” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The name of the themed icon displayed on the item.
This property only has an effect if not overridden by
<a class="link" href="GtkToolButton.html#GtkToolButton--label-widget" title="The “label-widget” property"><span class="type">“label-widget”</span></a>, <a class="link" href="GtkToolButton.html#GtkToolButton--icon-widget" title="The “icon-widget” property"><span class="type">“icon-widget”</span></a> or
@ -851,7 +851,7 @@ This property only has an effect if not overridden by
<hr>
<div class="refsect2">
<a name="GtkToolButton--label"></a><h3>The <code class="literal">“label”</code> property</h3>
<pre class="programlisting"> “label” <span class="type">gchar</span> *</pre>
<pre class="programlisting"> “label” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Text to show in the item.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -866,7 +866,7 @@ This property only has an effect if not overridden by
<hr>
<div class="refsect2">
<a name="GtkToolButton--stock-id"></a><h3>The <code class="literal">“stock-id”</code> property</h3>
<pre class="programlisting"> “stock-id” <span class="type">gchar</span> *</pre>
<pre class="programlisting"> “stock-id” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The stock icon displayed on the item.</p>
<div class="warning">
<p><code class="literal">GtkToolButton:stock-id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -878,7 +878,7 @@ This property only has an effect if not overridden by
<hr>
<div class="refsect2">
<a name="GtkToolButton--use-underline"></a><h3>The <code class="literal">“use-underline”</code> property</h3>
<pre class="programlisting"> “use-underline” <span class="type">gboolean</span></pre>
<pre class="programlisting"> “use-underline” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<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>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
@ -888,7 +888,7 @@ This property only has an effect if not overridden by
<a name="GtkToolButton.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkToolButton--s-icon-spacing"></a><h3>The <code class="literal">“icon-spacing”</code> style property</h3>
<pre class="programlisting"> “icon-spacing” <span class="type">gint</span></pre>
<pre class="programlisting"> “icon-spacing” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>Spacing in pixels between the icon and label.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
@ -901,7 +901,7 @@ This property only has an effect if not overridden by
<a name="GtkToolButton-clicked"></a><h3>The <code class="literal">“clicked”</code> signal</h3>
<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,
<span class="type">gpointer</span> user_data)</pre>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>This signal is emitted when the tool button is clicked with the mouse
or activated with the keyboard.</p>
<div class="refsect3">
@ -926,7 +926,7 @@ or activated with the keyboard.</p>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
</div>
<div class="refsect1">