gtkactiongroup.html

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

<p>
Looks up an action in the action group by name.</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>action_name</code></em>&#160;:</span></p></td>
<td> the name of the action
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the action, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no action by that name exists

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3971288"></a><h3>
<a name="gtk-action-group-list-actions"></a>gtk_action_group_list_actions ()</h3>
<a class="indexterm" name="id3971304"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              gtk_action_group_list_actions       (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);</pre>
<p>
Lists the actions in the action group.</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"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> an allocated list of the action objects in the action group

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3971374"></a><h3>
<a name="gtk-action-group-add-action"></a>gtk_action_group_add_action ()</h3>
<a class="indexterm" name="id3971390"></a><pre class="programlisting">void                gtk_action_group_add_action         (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Adds an action object to the action group. Note that this function
does not set up the accel path of the action, which can lead to problems
if a user tries to modify the accelerator of a menuitem associated with
the action. Therefore you must either set the accel path yourself with
<a class="link" href="GtkAction.html#gtk-action-set-accel-path"><code class="function">gtk_action_set_accel_path()</code></a>, or use 
<code class="literal">gtk_action_group_add_action_with_accel (..., NULL)</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>action</code></em>&#160;:</span></p></td>
<td> an action
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3971492"></a><h3>
<a name="gtk-action-group-add-action-with-accel"></a>gtk_action_group_add_action_with_accel ()</h3>
<a class="indexterm" name="id3971508"></a><pre class="programlisting">void                gtk_action_group_add_action_with_accel
                                                        (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *accelerator);</pre>
<p>
Adds an action object to the action group and sets up the accelerator.
</p>
<p>
If <em class="parameter"><code>accelerator</code></em> is <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, attempts to use the accelerator associated 
with the stock_id of the action. 
</p>
<p>
Accel paths 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>action</code></em>&#160;:</span></p></td>
<td> the action to add 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accelerator</code></em>&#160;:</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>, or "" for no accelerator, or 
  <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the stock accelerator 
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3971671"></a><h3>
<a name="gtk-action-group-remove-action"></a>gtk_action_group_remove_action ()</h3>
<a class="indexterm" name="id3971687"></a><pre class="programlisting">void                gtk_action_group_remove_action      (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Removes an action object from the action group.</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>action</code></em>&#160;:</span></p></td>
<td> an action
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3971767"></a><h3>
<a name="GtkActionEntry"></a>GtkActionEntry</h3>
<a class="indexterm" name="id3971780"></a><pre class="programlisting">typedef struct {
  const gchar     *name;
  const gchar     *stock_id;
  const gchar     *label;
  const gchar     *accelerator;
  const gchar     *tooltip;
  GCallback  callback;
} GtkActionEntry;
</pre>
<p>
<span class="structname">GtkActionEntry</span> structs are used with 
<a class="link" href="GtkActionGroup.html#gtk-action-group-add-actions"><code class="function">gtk_action_group_add_actions()</code></a> to construct 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>. If <em class="parameter"><code>label</code></em>
    is <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the label of the stock item with id <em class="parameter"><code>stock_id</code></em> is used.
</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/gobject/gobject-Closures.html#GCallback"
>GCallback</a>&#160;<em class="structfield"><code>callback</code></em>;</span></p></td>
<td>The function to call when the action is activated.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3972010"></a><h3>
<a name="gtk-action-group-add-actions"></a>gtk_action_group_add_actions ()</h3>
<a class="indexterm" name="id3972026"></a><pre class="programlisting">void                gtk_action_group_add_actions        (<a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
                                                         const <a class="link" href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</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#gpointer"
>gpointer</a> user_data);</pre>
<p>
This is a convenience function to create a number of actions and add them 
to the action group.
</p>
<p>
The "activate" signals of the actions are connected to the callbacks and 
their accel paths 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>