gtkradioaction.html

最新gtk中文资料集

<td> a new <a class="link" href="GtkRadioAction.html" title="GtkRadioAction"><span class="type">GtkRadioAction</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3992517"></a><h3>
<a name="gtk-radio-action-get-group"></a>gtk_radio_action_get_group ()</h3>
<a class="indexterm" name="id3992533"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a>*             gtk_radio_action_get_group          (<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *action);</pre>
<p>
Returns the list representing the radio group for this object.
Note that the returned list is only valid until the next change
to the group. 
</p>
<p>
A common way to set up a group of radio group is the following:
</p>
<div class="informalexample"><pre class="programlisting">
  GSList *group = NULL;
  GtkRadioAction *action;
 
  while (/* more actions to add */)
    {
       action = gtk_radio_action_new (...);
       
       gtk_radio_action_set_group (action, group);
       group = gtk_radio_action_get_group (action);
    }
</pre></div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></p></td>
<td> the action object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the list representing the radio group for this object

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3992622"></a><h3>
<a name="gtk-radio-action-set-group"></a>gtk_radio_action_set_group ()</h3>
<a class="indexterm" name="id3992639"></a><pre class="programlisting">void                gtk_radio_action_set_group          (<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *action,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a> *group);</pre>
<p>
Sets the radio group for the radio action object.</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>action</code></em>&#160;:</span></p></td>
<td> the action object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>group</code></em>&#160;:</span></p></td>
<td> a list representing a radio group
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3992718"></a><h3>
<a name="gtk-radio-action-get-current-value"></a>gtk_radio_action_get_current_value ()</h3>
<a class="indexterm" name="id3992735"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_radio_action_get_current_value  (<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *action);</pre>
<p>
Obtains the value property of the currently active member of 
the group to which <em class="parameter"><code>action</code></em> belongs.</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>action</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRadioAction.html" title="GtkRadioAction"><span class="type">GtkRadioAction</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The value of the currently active group member

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3992818"></a><h3>
<a name="gtk-radio-action-set-current-value"></a>gtk_radio_action_set_current_value ()</h3>
<a class="indexterm" name="id3992834"></a><pre class="programlisting">void                gtk_radio_action_set_current_value  (<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *action,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> current_value);</pre>
<p>
Sets the currently active group member to the member with value
property <em class="parameter"><code>current_value</code></em>.</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>action</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRadioAction.html" title="GtkRadioAction"><span class="type">GtkRadioAction</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>current_value</code></em>&#160;:</span></p></td>
<td> the new value
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3992929"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3992940"></a><h3>
<a name="GtkRadioAction--current-value"></a>The <code class="literal">"current-value"</code> property</h3>
<a class="indexterm" name="id3992957"></a><pre class="programlisting">  "current-value"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write</pre>
<p>
The value property of the currently active member of the group to which
this action belongs.</p>
<p>

</p>
<p>Default value: 0</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3992994"></a><h3>
<a name="GtkRadioAction--group"></a>The <code class="literal">"group"</code> property</h3>
<a class="indexterm" name="id3993010"></a><pre class="programlisting">  "group"                    <a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a>        : Write</pre>
<p>
Sets a new group for a radio action.</p>
<p>

</p>
<p>Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3993043"></a><h3>
<a name="GtkRadioAction--value"></a>The <code class="literal">"value"</code> property</h3>
<a class="indexterm" name="id3993059"></a><pre class="programlisting">  "value"                    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write</pre>
<p>
The value is an arbitrary integer which can be used as a
convenient way to determine which action in the group is 
currently active in an ::activate or ::changed signal handler.
See <a class="link" href="GtkRadioAction.html#gtk-radio-action-get-current-value"><code class="function">gtk_radio_action_get_current_value()</code></a> and <a class="link" href="GtkActionGroup.html#GtkRadioActionEntry"><span class="type">GtkRadioActionEntry</span></a>
for convenient ways to get and set this property.</p>
<p>

</p>
<p>Default value: 0</p>
<p>Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3993120"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3993131"></a><h3>
<a name="GtkRadioAction-changed"></a>The <code class="literal">"changed"</code> signal</h3>
<a class="indexterm" name="id3993147"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *action,
                                                        <a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a> *current,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)      : Run First / No Recursion</pre>
<p>
The ::changed signal is emitted on every member of a radio group when the
active member is changed. The signal gets emitted after the ::activate signals
for the previous and current active members.</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>action</code></em>&#160;:</span></p></td>
<td> the action on which the signal is emitted
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>current</code></em>&#160;:</span></p></td>
<td> the member of <em class="parameter"><code>action</code></em>s group which has just been activated
</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>
<p>Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3993259"></a><div class="refsect2" lang="en"><a name="id3993260"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3993261"></a></div>
</div>
</div>
</body>
</html>