gtkaction.html

最新gtk中文资料集

</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3982565"></a><h3>
<a name="gtk-action-create-menu-item"></a>gtk_action_create_menu_item ()</h3>
<a class="indexterm" name="id3982582"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_action_create_menu_item         (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Creates a menu item widget that proxies for the given action.</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"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a menu item connected to the action.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3982650"></a><h3>
<a name="gtk-action-create-tool-item"></a>gtk_action_create_tool_item ()</h3>
<a class="indexterm" name="id3982666"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_action_create_tool_item         (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Creates a toolbar item widget that proxies for the given action.</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"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a toolbar item connected to the action.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3982734"></a><h3>
<a name="gtk-action-create-menu"></a>gtk_action_create_menu ()</h3>
<a class="indexterm" name="id3982750"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_action_create_menu              (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
If <em class="parameter"><code>action</code></em> provides a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> widget as a submenu for the menu
item or the toolbar item it creates, this function returns an
instance of that menu.</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="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the menu item provided by the action, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3982851"></a><h3>
<a name="gtk-action-connect-proxy"></a>gtk_action_connect_proxy ()</h3>
<a class="indexterm" name="id3982866"></a><pre class="programlisting">void                gtk_action_connect_proxy            (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy);</pre>
<p>
Connects a widget to an action object as a proxy.  Synchronises 
various properties of the action with the widget (such as label 
text, icon, tooltip, etc), and attaches a callback so that the 
action gets activated when the proxy widget does.
</p>
<p>
If the widget is already connected to an action, it is disconnected
first.</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>proxy</code></em>&#160;:</span></p></td>
<td> the proxy widget
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3982953"></a><h3>
<a name="gtk-action-disconnect-proxy"></a>gtk_action_disconnect_proxy ()</h3>
<a class="indexterm" name="id3982970"></a><pre class="programlisting">void                gtk_action_disconnect_proxy         (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy);</pre>
<p>
Disconnects a proxy widget from an action.  
Does <span class="emphasis"><em>not</em></span> destroy the widget, however.</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>proxy</code></em>&#160;:</span></p></td>
<td> the proxy widget
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983052"></a><h3>
<a name="gtk-action-get-proxies"></a>gtk_action_get_proxies ()</h3>
<a class="indexterm" name="id3983068"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a>*             gtk_action_get_proxies              (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Returns the proxy widgets for an action.
See also <a class="link" href="GtkWidget.html#gtk-widget-get-action"><code class="function">gtk_widget_get_action()</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</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> a <a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
><span class="type">GSList</span></a> of proxy widgets. The list is owned by GTK+
and must not be modified.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983157"></a><h3>
<a name="gtk-action-connect-accelerator"></a>gtk_action_connect_accelerator ()</h3>
<a class="indexterm" name="id3983173"></a><pre class="programlisting">void                gtk_action_connect_accelerator      (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Installs the accelerator for <em class="parameter"><code>action</code></em> if <em class="parameter"><code>action</code></em> has an
accel path and group. See <a class="link" href="GtkAction.html#gtk-action-set-accel-path"><code class="function">gtk_action_set_accel_path()</code></a> and 
<a class="link" href="GtkAction.html#gtk-action-set-accel-group"><code class="function">gtk_action_set_accel_group()</code></a>
</p>
<p>
Since multiple proxies may independently trigger the installation
of the accelerator, the <em class="parameter"><code>action</code></em> counts the number of times this
function has been called and doesn't remove the accelerator until
<a class="link" href="GtkAction.html#gtk-action-disconnect-accelerator"><code class="function">gtk_action_disconnect_accelerator()</code></a> has been called as many times.</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="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983296"></a><h3>
<a name="gtk-action-disconnect-accelerator"></a>gtk_action_disconnect_accelerator ()</h3>
<a class="indexterm" name="id3983312"></a><pre class="programlisting">void                gtk_action_disconnect_accelerator   (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Undoes the effect of one call to <a class="link" href="GtkAction.html#gtk-action-connect-accelerator"><code class="function">gtk_action_connect_accelerator()</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</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983387"></a><h3>
<a name="gtk-action-block-activate-from"></a>gtk_action_block_activate_from ()</h3>
<a class="indexterm" name="id3983403"></a><pre class="programlisting">void                gtk_action_block_activate_from      (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy);</pre>
<p>
Disables calls to the <a class="link" href="GtkAction.html#gtk-action-activate"><code class="function">gtk_action_activate()</code></a>
function by signals on the given proxy widget.  This is used to
break notification loops for things like check or radio actions.
</p>
<p>
This function is intended for use by action implementations.</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>proxy</code></em>&#160;:</span></p></td>
<td> a proxy widget
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983499"></a><h3>
<a name="gtk-action-unblock-activate-from"></a>gtk_action_unblock_activate_from ()</h3>
<a class="indexterm" name="id3983515"></a><pre class="programlisting">void                gtk_action_unblock_activate_from    (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy);</pre>
<p>
Re-enables calls to the <a class="link" href="GtkAction.html#gtk-action-activate"><code class="function">gtk_action_activate()</code></a>
function by signals on the given proxy widget.  This undoes the
blocking done by <a class="link" href="GtkAction.html#gtk-action-block-activate-from"><code class="function">gtk_action_block_activate_from()</code></a>.
</p>
<p>
This function is intended for use by action implementations.</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>proxy</code></em>&#160;:</span></p></td>
<td> a proxy widget
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3983622"></a><h3>
<a name="gtk-action-get-accel-path"></a>gtk_action_get_accel_path ()</h3>
<a class="indexterm" name="id3983638"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_action_get_accel_path           (<a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a> *action);</pre>
<p>
Returns the accel path for this action.</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>