gtktogglebutton.html

来自「最新gtk中文资料集」· HTML 代码 · 共 673 行 · 第 1/3 页

<tr>
<td><p><span class="term"><em class="parameter"><code>toggle_button</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
><span class="type">gboolean</span></a> value.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3507971"></a><h3>
<a name="gtk-toggle-button-set-active"></a>gtk_toggle_button_set_active ()</h3>
<a class="indexterm" name="id3507985"></a><pre class="programlisting">void                gtk_toggle_button_set_active        (<a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a> *toggle_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> is_active);</pre>
<p>
Sets the status of the toggle button. Set to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if you want the
GtkToggleButton to be 'pressed in', and <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> to raise it.
This action causes the toggled signal to be emitted.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toggle_button</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>is_active</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> or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3508104"></a><h3>
<a name="gtk-toggle-button-get-inconsistent"></a>gtk_toggle_button_get_inconsistent ()</h3>
<a class="indexterm" name="id3508118"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_toggle_button_get_inconsistent  (<a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a> *toggle_button);</pre>
<p>
Gets the value set by <a class="link" href="GtkToggleButton.html#gtk-toggle-button-set-inconsistent"><code class="function">gtk_toggle_button_set_inconsistent()</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>toggle_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</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 is displayed as inconsistent, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3508220"></a><h3>
<a name="gtk-toggle-button-set-inconsistent"></a>gtk_toggle_button_set_inconsistent ()</h3>
<a class="indexterm" name="id3508233"></a><pre class="programlisting">void                gtk_toggle_button_set_inconsistent  (<a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a> *toggle_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> setting);</pre>
<p>
If the user has selected a range of elements (such as some text or
spreadsheet cells) that are affected by a toggle button, and the
current values in that range are inconsistent, you may want to
display the toggle in an "in between" state. This function turns on
"in between" display.  Normally you would turn off the inconsistent
state again if the user toggles the toggle button. This has to be
done manually, <a class="link" href="GtkToggleButton.html#gtk-toggle-button-set-inconsistent"><code class="function">gtk_toggle_button_set_inconsistent()</code></a> only affects
visual appearance, it doesn't affect the semantics of 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>toggle_button</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>setting</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 state is inconsistent
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3508344"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3508355"></a><h3>
<a name="GtkToggleButton--active"></a>The <code class="literal">"active"</code> property</h3>
<a class="indexterm" name="id3508371"></a><pre class="programlisting">  "active"                   <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>If the toggle button should be pressed in or not.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3508398"></a><h3>
<a name="GtkToggleButton--draw-indicator"></a>The <code class="literal">"draw-indicator"</code> property</h3>
<a class="indexterm" name="id3508415"></a><pre class="programlisting">  "draw-indicator"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>If the toggle part of the button is displayed.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3508442"></a><h3>
<a name="GtkToggleButton--inconsistent"></a>The <code class="literal">"inconsistent"</code> property</h3>
<a class="indexterm" name="id3508459"></a><pre class="programlisting">  "inconsistent"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>If the toggle button is in an "in between" state.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3508487"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3508497"></a><h3>
<a name="GtkToggleButton-toggled"></a>The <code class="literal">"toggled"</code> signal</h3>
<a class="indexterm" name="id3508513"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a> *togglebutton,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>         user_data)         : Run First</pre>
<p>
Should be connected if you wish to perform an action whenever the
<a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>'s state is changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>togglebutton</code></em>&#160;:</span></p></td>
<td>the object which received the signal.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3508594"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></span></p></td>
<td><p>a more general button.</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="GtkCheckButton.html" title="GtkCheckButton"><span class="type">GtkCheckButton</span></a></span></p></td>
<td><p>another way of presenting a toggle option.</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem"><span class="type">GtkCheckMenuItem</span></a></span></p></td>
<td><p>a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>  as a menu item.</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3508667"></a><div class="refsect2" lang="en"><a name="id3508668"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3508669"></a></div>
</div>
</div>
</body>
</html>