gtkactiongroup.html

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

} GtkRadioActionEntry;
</pre>
<p>
<span class="structname">GtkRadioActionEntry</span> structs are used with 
<a class="link" href="GtkActionGroup.html#gtk-action-group-add-radio-actions"><code class="function">gtk_action_group_add_radio_actions()</code></a> to construct groups of radio actions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>name</code></em>;</span></p></td>
<td>The name of the action.
</td>
</tr>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>stock_id</code></em>;</span></p></td>
<td>The stock id for the action, or the name of an icon from the icon 
    theme.
</td>
</tr>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>label</code></em>;</span></p></td>
<td>The label for the action. This field should typically be marked for 
    translation, see <a class="link" href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>accelerator</code></em>;</span></p></td>
<td>The accelerator for the action, in the format understood by 
    <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>tooltip</code></em>;</span></p></td>
<td>The tooltip for the action. This field should typically be marked for 
    translation, see <a class="link" href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>&#160;<em class="structfield"><code>value</code></em>;</span></p></td>
<td>The value to set on the radio action. See <a class="link" href="GtkRadioAction.html#gtk-radio-action-get-current-value"><code class="function">gtk_radio_action_get_current_value()</code></a>.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3973194"></a><h3>
<a name="gtk-action-group-add-radio-actions"></a>gtk_action_group_add_radio_actions ()</h3>
<a class="indexterm" name="id3973209"></a><pre class="programlisting">void                gtk_action_group_add_radio_actions  (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         const <a class="link" href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> value,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
This is a convenience routine to create a group of radio actions and
add them to the action group. 
</p>
<p>
The "changed" signal of the first radio action is connected to the 
<em class="parameter"><code>on_change</code></em> callback and the accel paths of the actions are set to 
<code class="literal">&lt;Actions&gt;/<em class="replaceable"><code>group-name</code></em>/<em class="replaceable"><code>action-name</code></em></code>.</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_group</code></em>&#160;:</span></p></td>
<td> the action group
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em>&#160;:</span></p></td>
<td> an array of radio action descriptions
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em>&#160;:</span></p></td>
<td> the number of entries
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
<td> the value of the action to activate initially, or -1 if
  no action should be activated
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>on_change</code></em>&#160;:</span></p></td>
<td> the callback to connect to the changed signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td> data to pass to the action callbacks
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3973403"></a><h3>
<a name="gtk-action-group-add-radio-actions-full"></a>gtk_action_group_add_radio_actions_full ()</h3>
<a class="indexterm" name="id3973420"></a><pre class="programlisting">void                gtk_action_group_add_radio_actions_full
                                                        (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         const <a class="link" href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> value,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);</pre>
<p>
This variant of <a class="link" href="GtkActionGroup.html#gtk-action-group-add-radio-actions"><code class="function">gtk_action_group_add_radio_actions()</code></a> adds a 
<a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
><span class="type">GDestroyNotify</span></a> callback for <em class="parameter"><code>user_data</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_group</code></em>&#160;:</span></p></td>
<td> the action group
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em>&#160;:</span></p></td>
<td> an array of radio action descriptions
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em>&#160;:</span></p></td>
<td> the number of entries
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
<td> the value of the action to activate initially, or -1 if
  no action should be activated
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>on_change</code></em>&#160;:</span></p></td>
<td> the callback to connect to the changed signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td> data to pass to the action callbacks
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy</code></em>&#160;:</span></p></td>
<td> destroy notification callback for <em class="parameter"><code>user_data</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3973645"></a><h3>
<a name="gtk-action-group-set-translate-func"></a>gtk_action_group_set_translate_func ()</h3>
<a class="indexterm" name="id3973662"></a><pre class="programlisting">void                gtk_action_group_set_translate_func (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         <a class="link" href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a class="link" href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> notify);</pre>
<p>
Sets a function to be used for translating the <em class="parameter"><code>label</code></em> and <em class="parameter"><code>tooltip</code></em> of 
<span class="type">GtkActionGroupEntry</span>s added by <a class="link" href="GtkActionGroup.html#gtk-action-group-add-actions"><code class="function">gtk_action_group_add_actions()</code></a>.
</p>
<p>
If you're using <code class="function">gettext()</code>, it is enough to set the translation domain
with <a class="link" href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</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>action_group</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html#GtkTranslateFunc"><span class="type">GtkTranslateFunc</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data to be passed to <em class="parameter"><code>func</code></em> and <em class="parameter"><code>notify</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-Types.html#GtkDestroyNotify"><span class="type">GtkDestroyNotify</span></a> function to be called when <em class="parameter"><code>action_group</code></em> is 
  destroyed and when the translation function is changed again
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4 
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3973889"></a><h3>
<a name="gtk-action-group-set-translation-domain"></a>gtk_action_group_set_translation_domain ()</h3>
<a class="indexterm" name="id3973905"></a><pre class="programlisting">void                gtk_action_group_set_translation_domain
                                                        (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *domain);</pre>
<p>
Sets the translation domain and uses <code class="function">dgettext()</code> for translating the 
<em class="parameter"><code>label</code></em> and <em class="parameter"><code>tooltip</code></em> of <a class="link" href="GtkActionGroup.html#GtkActionEntry"><span class="type">GtkActionEntry</span></a>s added by 
<a class="link" href="GtkActionGroup.html#gtk-action-group-add-actions"><code class="function">gtk_action_group_add_actions()</code></a>.
</p>
<p>
If you're not using <code class="function">gettext()</code> for localization, see 
<a class="link" href="GtkActionGroup.html#gtk-action-group-set-translate-func"><code class="function">gtk_action_group_set_translate_func()</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>action_group</code></em>&#160