gtkbutton.html

最新gtk中文资料集

</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3492811"></a><h3>
<a name="gtk-button-get-relief"></a>gtk_button_get_relief ()</h3>
<a class="indexterm" name="id3492824"></a><pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a>      gtk_button_get_relief               (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button);</pre>
<p>
Returns the current relief style of the given <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>.
</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>The <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> you want the <a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle"><span class="type">GtkReliefStyle</span></a> from.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>The current <a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3492914"></a><h3>
<a name="gtk-button-get-label"></a>gtk_button_get_label ()</h3>
<a class="indexterm" name="id3492928"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_button_get_label                (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button);</pre>
<p>
Fetches the text from the label of the button, as set by
<a class="link" href="GtkButton.html#gtk-button-set-label"><code class="function">gtk_button_set_label()</code></a>. If the label text has not 
been set the return value will be <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>. This will be the 
case if you create an empty button with <a class="link" href="GtkButton.html#gtk-button-new"><code class="function">gtk_button_new()</code></a> to 
use as a container.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The text of the label widget. This string is owned
by the widget and must not be modified or freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493033"></a><h3>
<a name="gtk-button-set-label"></a>gtk_button_set_label ()</h3>
<a class="indexterm" name="id3493046"></a><pre class="programlisting">void                gtk_button_set_label                (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label);</pre>
<p>
Sets the text of the label of the button to <em class="parameter"><code>str</code></em>. This text is
also used to select the stock item if <a class="link" href="GtkButton.html#gtk-button-set-use-stock"><code class="function">gtk_button_set_use_stock()</code></a>
is used.
</p>
<p>
This will also clear any previously set labels.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></p></td>
<td> a string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493148"></a><h3>
<a name="gtk-button-get-use-stock"></a>gtk_button_get_use_stock ()</h3>
<a class="indexterm" name="id3493160"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_button_get_use_stock            (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button);</pre>
<p>
Returns whether the button label is 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>button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the button label is used to
              select a stock item instead of being
              used directly as the label text.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493241"></a><h3>
<a name="gtk-button-set-use-stock"></a>gtk_button_set_use_stock ()</h3>
<a class="indexterm" name="id3493254"></a><pre class="programlisting">void                gtk_button_set_use_stock            (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> use_stock);</pre>
<p>
If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the label set on the button is used as a
stock id to select the stock item for the button.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>use_stock</code></em>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the button should use a stock item
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493355"></a><h3>
<a name="gtk-button-get-use-underline"></a>gtk_button_get_use_underline ()</h3>
<a class="indexterm" name="id3493369"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_button_get_use_underline        (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button);</pre>
<p>
Returns whether an embedded underline in the button label indicates a
mnemonic. See <a class="link" href="GtkButton.html#gtk-button-set-use-underline"><code class="function">gtk_button_set_use_underline()</code></a>.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if an embedded underline in the button label
              indicates the mnemonic accelerator keys.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493461"></a><h3>
<a name="gtk-button-set-use-underline"></a>gtk_button_set_use_underline ()</h3>
<a class="indexterm" name="id3493474"></a><pre class="programlisting">void                gtk_button_set_use_underline        (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> use_underline);</pre>
<p>
If true, an underline in the text of the button label indicates
the next character should be used for the mnemonic accelerator key.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>use_underline</code></em>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3493566"></a><h3>
<a name="gtk-button-set-focus-on-click"></a>gtk_button_set_focus_on_click ()</h3>
<a class="indexterm" name="id3493582"></a><pre class="programlisting">void                gtk_button_set_focus_on_click       (<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> focus_on_click);</pre>
<p>
Sets whether the button will grab focus when it is clicked with the mouse.
Making mouse clicks not grab focus is useful in places like toolbars where
you don't want the keyboard focus removed from the main area of the
application.</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="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>focus_on_click</code></em>&#160;:</span></p></td>
<td> whether the button grabs focus when clicked with the mouse
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">