gtktoolbutton.html

最新gtk中文资料集

</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
"icon_widget" and "stock_id". If "icon_widget" is non-<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, then
that widget is used as the icon. Otherwise, if "stock_id" is
non-<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the icon is determined by the stock item. Otherwise,
the button does not have a label.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3945095"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3945106"></a><h3>
<a name="GtkToolButton-struct"></a>GtkToolButton</h3>
<a class="indexterm" name="id3945119"></a><pre class="programlisting">typedef struct _GtkToolButton GtkToolButton;</pre>
<p>
The <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> struct contains only private. It should only be
accessed with the function described below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945144"></a><h3>
<a name="gtk-tool-button-new"></a>gtk_tool_button_new ()</h3>
<a class="indexterm" name="id3945159"></a><pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        gtk_tool_button_new                 (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon_widget,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label);</pre>
<p>
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
label.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon_widget</code></em>&#160;:</span></p></td>
<td> a widget that will be used as icon widget, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></p></td>
<td> a string that will be used as label, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945300"></a><h3>
<a name="gtk-tool-button-new-from-stock"></a>gtk_tool_button_new_from_stock ()</h3>
<a class="indexterm" name="id3945316"></a><pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        gtk_tool_button_new_from_stock      (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *stock_id);</pre>
<p>
Creates a new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> containing the image and text from a
stock item. Some stock ids have preprocessor macros like <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS"><span class="type">GTK_STOCK_OK</span></a>
and <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-APPLY:CAPS"><span class="type">GTK_STOCK_APPLY</span></a>.
</p>
<p>
It is an error if <em class="parameter"><code>stock_id</code></em> is not a name of a stock item.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></p></td>
<td> the name of the stock item 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A new <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945429"></a><h3>
<a name="gtk-tool-button-set-label"></a>gtk_tool_button_set_label ()</h3>
<a class="indexterm" name="id3945445"></a><pre class="programlisting">void                gtk_tool_button_set_label           (<a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label);</pre>
<p>
Sets <em class="parameter"><code>label</code></em> as the label used for the tool button. The "label" property
only has an effect if not overridden by a non-<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> "label_widget" property.
If both the "label_widget" and "label" properties are <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the label
is determined by the "stock_id" property. If the "stock_id" property is also
<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have a label.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></p></td>
<td> a string that will be used as label, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945588"></a><h3>
<a name="gtk-tool-button-get-label"></a>gtk_tool_button_get_label ()</h3>
<a class="indexterm" name="id3945604"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_tool_button_get_label           (<a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
<p>
Returns the label used by the tool button, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The label, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945704"></a><h3>
<a name="gtk-tool-button-set-use-underline"></a>gtk_tool_button_set_use_underline ()</h3>
<a class="indexterm" name="id3945721"></a><pre class="programlisting">void                gtk_tool_button_set_use_underline   (<a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> use_underline);</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 <a
href="/usr/share/gtk-doc/html/glib/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
only affects the menu item on the overflow menu.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>use_underline</code></em>&#160;:</span></p></td>
<td> whether the button label has the form "_Open"
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3945834"></a><h3>
<a name="gtk-tool-button-get-use-underline"></a>gtk_tool_button_get_use_underline ()</h3>
<a class="indexterm" name="id3945851"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_tool_button_get_use_underline   (<a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</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"><code class="function">gtk_tool_button_set_use_underline()</code></a>.</p>