|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21585/root/usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkActionGroup</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="Actions.html" title="Action-based menus and toolbars">
<link rel="prev" href="GtkUIManager.html" title="GtkUIManager">
<link rel="next" href="GtkAction.html" title="GtkAction">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkUIManager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="Actions.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkAction.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3361810" class="shortcut">Top</a>
 | 
<a href="#id3362919" class="shortcut">Description</a>
 | 
<a href="#id3362630" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3362654" class="shortcut">Properties</a>
 | 
<a href="#id3362723" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkActionGroup"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3361810"></a><span class="refentrytitle">GtkActionGroup</span>
</h2>
<p>GtkActionGroup — A group of actions</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkActionGroup.html#GtkActionGroup-struct">GtkActionGroup</a>;
<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a>* <a href="GtkActionGroup.html#gtk-action-group-new">gtk_action_group_new</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="GtkActionGroup.html#gtk-action-group-get-name">gtk_action_group_get_name</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GtkActionGroup.html#gtk-action-group-get-sensitive">gtk_action_group_get_sensitive</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);
void <a href="GtkActionGroup.html#gtk-action-group-set-sensitive">gtk_action_group_set_sensitive</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> sensitive);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GtkActionGroup.html#gtk-action-group-get-visible">gtk_action_group_get_visible</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);
void <a href="GtkActionGroup.html#gtk-action-group-set-visible">gtk_action_group_set_visible</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> visible);
<a href="GtkAction.html" title="GtkAction">GtkAction</a>* <a href="GtkActionGroup.html#gtk-action-group-get-action">gtk_action_group_get_action</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *action_name);
<a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>* <a href="GtkActionGroup.html#gtk-action-group-list-actions">gtk_action_group_list_actions</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);
void <a href="GtkActionGroup.html#gtk-action-group-add-action">gtk_action_group_add_action</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action);
void <a href="GtkActionGroup.html#gtk-action-group-add-action-with-accel">gtk_action_group_add_action_with_accel</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *accelerator);
void <a href="GtkActionGroup.html#gtk-action-group-remove-action">gtk_action_group_remove_action</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action);
<a href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</a>;
void <a href="GtkActionGroup.html#gtk-action-group-add-actions">gtk_action_group_add_actions</a> (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="GtkActionGroup.html#gtk-action-group-add-actions-full">gtk_action_group_add_actions_full</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);
<a href="GtkActionGroup.html#GtkToggleActionEntry">GtkToggleActionEntry</a>;
void <a href="GtkActionGroup.html#gtk-action-group-add-toggle-actions">gtk_action_group_add_toggle_actions</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkToggleActionEntry">GtkToggleActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="GtkActionGroup.html#gtk-action-group-add-toggle-actions-full">gtk_action_group_add_toggle_actions_full</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkToggleActionEntry">GtkToggleActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);
<a href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a>;
void <a href="GtkActionGroup.html#gtk-action-group-add-radio-actions">gtk_action_group_add_radio_actions</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
void <a href="GtkActionGroup.html#gtk-action-group-add-radio-actions-full">gtk_action_group_add_radio_actions_full</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);
void <a href="GtkActionGroup.html#gtk-action-group-set-translate-func">gtk_action_group_set_translate_func</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> notify);
void <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain">gtk_action_group_set_translation_domain</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *domain);
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="GtkActionGroup.html#gtk-action-group-translate-string">gtk_action_group_translate_string</a>
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *string);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3362630"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----GtkActionGroup
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3362654"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GtkActionGroup.html#GtkActionGroup--name">name</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write / Construct Only
"<a href="GtkActionGroup.html#GtkActionGroup--sensitive">sensitive</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkActionGroup.html#GtkActionGroup--visible">visible</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3362723"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GtkActionGroup.html#GtkActionGroup-connect-proxy">connect-proxy</a>"
void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) :
"<a href="GtkActionGroup.html#GtkActionGroup-disconnect-proxy">disconnect-proxy</a>"
void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) :
"<a href="GtkActionGroup.html#GtkActionGroup-post-activate">post-activate</a>"
void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) :
"<a href="GtkActionGroup.html#GtkActionGroup-pre-activate">pre-activate</a>"
void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) :
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3362919"></a><h2>Description</h2>
<p>
Actions are organised into groups. An action group is essentially a
map from names to <a href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> objects.
</p>
<p>
All actions that would make sense to use in a particular context
should be in a single group. Multiple action groups may be used for a
particular user interface. In fact, it is expected that most nontrivial
applications will make use of multiple groups. For example, in an application
that can edit multiple documents, one group holding global actions
(e.g. quit, about, new), and one group per document holding actions that
act on that document (eg. save, cut/copy/paste, etc). Each window's menus
would be constructed from a combination of two action groups.
</p>
<p><a name="Action-Accel"></a>
Accelerators are handled by the GTK+ accelerator map. All actions are assigned an
accelerator path (which normally has the form
<code class="literal"><Actions>/<em class="replaceable"><code>group-name</code></em>/<em class="replaceable"><code>action-name</code></em></code>)
and a shortcut is associated with this accelerator path. All menuitems and
toolitems take on this accelerator path. The GTK+ accelerator map code makes
sure that the correct shortcut is displayed next to the menu item.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3362981"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3362991"></a><h3>
<a name="GtkActionGroup-struct"></a>GtkActionGroup</h3>
<a class="indexterm" name="id3363004"></a><pre class="programlisting">typedef struct _GtkActionGroup GtkActionGroup;</pre>
<p>
The <span class="structname">GtkActionGroup</span> struct contains only private
members and should not be accessed directly.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363025"></a><h3>
<a name="gtk-action-group-new"></a>gtk_action_group_new ()</h3>
<a class="indexterm" name="id3363040"></a><pre class="programlisting"><a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a>* gtk_action_group_new (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Creates a new <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> object. The name of the action group
is used when associating <a href="GtkActionGroup.html#Action-Accel">keybindings</a>
with the actions.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the action group.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363132"></a><h3>
<a name="gtk-action-group-get-name"></a>gtk_action_group_get_name ()</h3>
<a class="indexterm" name="id3363148"></a><pre class="programlisting">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gtk_action_group_get_name (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);</pre>
<p>
Gets the name of the action group.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the name of the action group.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363215"></a><h3>
<a name="gtk-action-group-get-sensitive"></a>gtk_action_group_get_sensitive ()</h3>
<a class="indexterm" name="id3363230"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gtk_action_group_get_sensitive (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);</pre>
<p>
Returns <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the group is sensitive. The constituent actions
can only be logically sensitive (see <a href="GtkAction.html#gtk-action-is-sensitive"><code class="function">gtk_action_is_sensitive()</code></a>) if
they are sensitive (see <a href="GtkAction.html#gtk-action-get-sensitive"><code class="function">gtk_action_get_sensitive()</code></a>) and their group
is sensitive.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the group is sensitive.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363344"></a><h3>
<a name="gtk-action-group-set-sensitive"></a>gtk_action_group_set_sensitive ()</h3>
<a class="indexterm" name="id3363359"></a><pre class="programlisting">void gtk_action_group_set_sensitive (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> sensitive);</pre>
<p>
Changes the sensitivity of <em class="parameter"><code>action_group</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sensitive</code></em> :</span></td>
<td> new sensitivity
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363441"></a><h3>
<a name="gtk-action-group-get-visible"></a>gtk_action_group_get_visible ()</h3>
<a class="indexterm" name="id3363457"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gtk_action_group_get_visible (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group);</pre>
<p>
Returns <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the group is visible. The constituent actions
can only be logically visible (see <a href="GtkAction.html#gtk-action-is-visible"><code class="function">gtk_action_is_visible()</code></a>) if
they are visible (see <a href="GtkAction.html#gtk-action-get-visible"><code class="function">gtk_action_get_visible()</code></a>) and their group
is visible.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the group is visible.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363570"></a><h3>
<a name="gtk-action-group-set-visible"></a>gtk_action_group_set_visible ()</h3>
<a class="indexterm" name="id3363586"></a><pre class="programlisting">void gtk_action_group_set_visible (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> visible);</pre>
<p>
Changes the visible of <em class="parameter"><code>action_group</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>visible</code></em> :</span></td>
<td> new visiblity
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363669"></a><h3>
<a name="gtk-action-group-get-action"></a>gtk_action_group_get_action ()</h3>
<a class="indexterm" name="id3363685"></a><pre class="programlisting"><a href="GtkAction.html" title="GtkAction">GtkAction</a>* gtk_action_group_get_action (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *action_name);</pre>
<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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_name</code></em> :</span></td>
<td> the name of the action
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the action, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no action by that name exists
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363783"></a><h3>
<a name="gtk-action-group-list-actions"></a>gtk_action_group_list_actions ()</h3>
<a class="indexterm" name="id3363799"></a><pre class="programlisting"><a
href="../glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>* gtk_action_group_list_actions (<a 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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> an allocated list of the action objects in the action group
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363866"></a><h3>
<a name="gtk-action-group-add-action"></a>gtk_action_group_add_action ()</h3>
<a class="indexterm" name="id3363883"></a><pre class="programlisting">void gtk_action_group_add_action (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a 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 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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> an action
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363982"></a><h3>
<a name="gtk-action-group-add-action-with-accel"></a>gtk_action_group_add_action_with_accel ()</h3>
<a class="indexterm" name="id3363998"></a><pre class="programlisting">void gtk_action_group_add_action_with_accel
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
const <a
href="../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="../glib/glib-Standard-Macros.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"><Actions>/<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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> the action to add
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accelerator</code></em> :</span></td>
<td> the accelerator for the action, in
the format understood by <a href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>, or "" for no accelerator, or
<a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the stock accelerator
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3364159"></a><h3>
<a name="gtk-action-group-remove-action"></a>gtk_action_group_remove_action ()</h3>
<a class="indexterm" name="id3364175"></a><pre class="programlisting">void gtk_action_group_remove_action (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a 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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> an action
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3364252"></a><h3>
<a name="GtkActionEntry"></a>GtkActionEntry</h3>
<a class="indexterm" name="id3364265"></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 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>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>name</code></em>;</span></td>
<td>The name of the action.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>stock_id</code></em>;</span></td>
<td>The stock id for the action, or the name of an icon from the icon
theme.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>label</code></em>;</span></td>
<td>The label for the action. This field should typically be marked for
translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>accelerator</code></em>;</span></td>
<td>The accelerator for the action, in the format understood by
<a href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>tooltip</code></em>;</span></td>
<td>The tooltip for the action. This field should typically be marked
for translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> <em class="structfield"><code>callback</code></em>;</span></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="id3364471"></a><h3>
<a name="gtk-action-group-add-actions"></a>gtk_action_group_add_actions ()</h3>
<a class="indexterm" name="id3364487"></a><pre class="programlisting">void gtk_action_group_add_actions (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../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"><Actions>/<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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3364627"></a><h3>
<a name="gtk-action-group-add-actions-full"></a>gtk_action_group_add_actions_full ()</h3>
<a class="indexterm" name="id3364644"></a><pre class="programlisting">void gtk_action_group_add_actions_full
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkActionEntry">GtkActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);</pre>
<p>
This variant of <a href="GtkActionGroup.html#gtk-action-group-add-actions"><code class="function">gtk_action_group_add_actions()</code></a> adds a <a
href="../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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy</code></em> :</span></td>
<td> destroy notification callback for <em class="parameter"><code>user_data</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3364819"></a><h3>
<a name="GtkToggleActionEntry"></a>GtkToggleActionEntry</h3>
<a class="indexterm" name="id3364832"></a><pre class="programlisting">typedef struct {
const gchar *name;
const gchar *stock_id;
const gchar *label;
const gchar *accelerator;
const gchar *tooltip;
GCallback callback;
gboolean is_active;
} GtkToggleActionEntry;
</pre>
<p>
<span class="structname">GtkToggleActionEntry</span> structs are used with
<a href="GtkActionGroup.html#gtk-action-group-add-toggle-actions"><code class="function">gtk_action_group_add_toggle_actions()</code></a> to construct toggle actions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>name</code></em>;</span></td>
<td>The name of the action.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>stock_id</code></em>;</span></td>
<td>The stock id for the action, or the name of an icon from the icon
theme.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>label</code></em>;</span></td>
<td>The label for the action. This field should typically be marked for
translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>accelerator</code></em>;</span></td>
<td>The accelerator for the action, in the format understood by
<a href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>tooltip</code></em>;</span></td>
<td>The tooltip for the action. This field should typically be marked
for translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> <em class="structfield"><code>callback</code></em>;</span></td>
<td>The function to call when the action is activated.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <em class="structfield"><code>is_active</code></em>;</span></td>
<td>The initial state of the toggle action.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3365060"></a><h3>
<a name="gtk-action-group-add-toggle-actions"></a>gtk_action_group_add_toggle_actions ()</h3>
<a class="indexterm" name="id3365077"></a><pre class="programlisting">void gtk_action_group_add_toggle_actions
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkToggleActionEntry">GtkToggleActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
This is a convenience function to create a number of toggle 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"><Actions>/<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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of toggle action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3365217"></a><h3>
<a name="gtk-action-group-add-toggle-actions-full"></a>gtk_action_group_add_toggle_actions_full ()</h3>
<a class="indexterm" name="id3365233"></a><pre class="programlisting">void gtk_action_group_add_toggle_actions_full
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkToggleActionEntry">GtkToggleActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);</pre>
<p>
This variant of <a href="GtkActionGroup.html#gtk-action-group-add-toggle-actions"><code class="function">gtk_action_group_add_toggle_actions()</code></a> adds a
<a
href="../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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of toggle action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy</code></em> :</span></td>
<td> destroy notification callback for <em class="parameter"><code>user_data</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3365410"></a><h3>
<a name="GtkRadioActionEntry"></a>GtkRadioActionEntry</h3>
<a class="indexterm" name="id3365423"></a><pre class="programlisting">typedef struct {
const gchar *name;
const gchar *stock_id;
const gchar *label;
const gchar *accelerator;
const gchar *tooltip;
gint value;
} GtkRadioActionEntry;
</pre>
<p>
<span class="structname">GtkRadioActionEntry</span> structs are used with
<a 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>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>name</code></em>;</span></td>
<td>The name of the action.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>stock_id</code></em>;</span></td>
<td>The stock id for the action, or the name of an icon from the icon
theme.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>label</code></em>;</span></td>
<td>The label for the action. This field should typically be marked for
translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>accelerator</code></em>;</span></td>
<td>The accelerator for the action, in the format understood by
<a href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>tooltip</code></em>;</span></td>
<td>The tooltip for the action. This field should typically be marked for
translation, see <a href="GtkActionGroup.html#gtk-action-group-set-translation-domain"><code class="function">gtk_action_group_set_translation_domain()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <em class="structfield"><code>value</code></em>;</span></td>
<td>The value to set on the radio action. See <a 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="id3365643"></a><h3>
<a name="gtk-action-group-add-radio-actions"></a>gtk_action_group_add_radio_actions ()</h3>
<a class="indexterm" name="id3365658"></a><pre class="programlisting">void gtk_action_group_add_radio_actions
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
<a
href="../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"><Actions>/<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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of radio action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td> the value of the action to activate initially, or -1 if
no action should be activated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>on_change</code></em> :</span></td>
<td> the callback to connect to the changed signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3365850"></a><h3>
<a name="gtk-action-group-add-radio-actions-full"></a>gtk_action_group_add_radio_actions_full ()</h3>
<a class="indexterm" name="id3365866"></a><pre class="programlisting">void gtk_action_group_add_radio_actions_full
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a href="GtkActionGroup.html#GtkRadioActionEntry">GtkRadioActionEntry</a> *entries,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> on_change,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy);</pre>
<p>
This variant of <a href="GtkActionGroup.html#gtk-action-group-add-radio-actions"><code class="function">gtk_action_group_add_radio_actions()</code></a> adds a
<a
href="../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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the action group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>entries</code></em> :</span></td>
<td> an array of radio action descriptions
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_entries</code></em> :</span></td>
<td> the number of entries
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td> the value of the action to activate initially, or -1 if
no action should be activated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>on_change</code></em> :</span></td>
<td> the callback to connect to the changed signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> data to pass to the action callbacks
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destroy</code></em> :</span></td>
<td> destroy notification callback for <em class="parameter"><code>user_data</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366087"></a><h3>
<a name="gtk-action-group-set-translate-func"></a>gtk_action_group_set_translate_func ()</h3>
<a class="indexterm" name="id3366104"></a><pre class="programlisting">void gtk_action_group_set_translate_func
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkItemFactory.html#GtkTranslateFunc">GtkTranslateFunc</a> func,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
<a 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 href="GtkActionGroup.html#gtk-action-group-add-actions"><code class="function">gtk_action_group_add_actions()</code></a>.
</p>
<p>
If you're using <a
href="../libbonobo/libbonobo-bonobo-i18n.html#gettext"
><code class="function">gettext()</code></a>, it is enough to set the translation domain
with <a 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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> a <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func</code></em> :</span></td>
<td> a <a href="GtkItemFactory.html#GtkTranslateFunc"><span class="type">GtkTranslateFunc</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></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>
<span class="term"><em class="parameter"><code>notify</code></em> :</span></td>
<td> a <a 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>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366329"></a><h3>
<a name="gtk-action-group-set-translation-domain"></a>gtk_action_group_set_translation_domain ()</h3>
<a class="indexterm" name="id3366345"></a><pre class="programlisting">void gtk_action_group_set_translation_domain
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *domain);</pre>
<p>
Sets the translation domain and uses <a
href="../libbonobo/libbonobo-bonobo-i18n.html#dgettext"
><code class="function">dgettext()</code></a> for translating the
<em class="parameter"><code>label</code></em> and <em class="parameter"><code>tooltip</code></em> of <a href="GtkActionGroup.html#GtkActionEntry"><span class="type">GtkActionEntry</span></a>s added by
<a 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 <a
href="../libbonobo/libbonobo-bonobo-i18n.html#gettext"
><code class="function">gettext()</code></a> for localization, see
<a 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>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> a <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>domain</code></em> :</span></td>
<td> the translation domain to use for <a
href="../libbonobo/libbonobo-bonobo-i18n.html#dgettext"
><code class="function">dgettext()</code></a> calls
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366511"></a><h3>
<a name="gtk-action-group-translate-string"></a>gtk_action_group_translate_string ()</h3>
<a class="indexterm" name="id3366528"></a><pre class="programlisting">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gtk_action_group_translate_string
(<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *string);</pre>
<p>
Translates a string using the specified <code class="function">translate_func()</code>. This
is mainly intended for language bindings.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> a <a href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em> :</span></td>
<td> a string
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the translation of <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.6
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3366644"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3366654"></a><h3>
<a name="GtkActionGroup--name"></a>The "<code class="literal">name</code>" property</h3>
<a class="indexterm" name="id3366671"></a><pre class="programlisting"> "name" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write / Construct Only</pre>
<p>A name for the action group.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366699"></a><h3>
<a name="GtkActionGroup--sensitive"></a>The "<code class="literal">sensitive</code>" property</h3>
<a class="indexterm" name="id3366715"></a><pre class="programlisting"> "sensitive" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the action group is enabled.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366741"></a><h3>
<a name="GtkActionGroup--visible"></a>The "<code class="literal">visible</code>" property</h3>
<a class="indexterm" name="id3366758"></a><pre class="programlisting"> "visible" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the action group is visible.</p>
<p>Default value: TRUE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3366786"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3366796"></a><h3>
<a name="GtkActionGroup-connect-proxy"></a>The "connect-proxy" signal</h3>
<a class="indexterm" name="id3366807"></a><pre class="programlisting">void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : </pre>
<p>
The connect_proxy signal is emitted after connecting a proxy to
an action in the group. Note that the proxy may have been connected
to a different action before.
</p>
<p>
This is intended for simple customizations for which a custom action
class would be too clumsy, e.g. showing tooltips for menuitems in the
statusbar.
</p>
<p>
<a href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> proxies the signal and provides global notification
just before any action is connected to a proxy, which is probably more
convenient to use.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> the action
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>proxy</code></em> :</span></td>
<td> the proxy
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3366949"></a><h3>
<a name="GtkActionGroup-disconnect-proxy"></a>The "disconnect-proxy" signal</h3>
<a class="indexterm" name="id3366960"></a><pre class="programlisting">void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *proxy,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : </pre>
<p>
The disconnect_proxy signal is emitted after disconnecting a proxy
from an action in the group.
</p>
<p>
<a href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> proxies the signal and provides global notification
just before any action is connected to a proxy, which is probably more
convenient to use.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> the action
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>proxy</code></em> :</span></td>
<td> the proxy
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3367094"></a><h3>
<a name="GtkActionGroup-post-activate"></a>The "post-activate" signal</h3>
<a class="indexterm" name="id3367106"></a><pre class="programlisting">void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : </pre>
<p>
The post_activate signal is emitted just after the <em class="parameter"><code>action</code></em> in the
<em class="parameter"><code>action_group</code></em> is activated
</p>
<p>
This is intended for <a href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> to proxy the signal and provide global
notification just after any action is activated.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> the action
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3367230"></a><h3>
<a name="GtkActionGroup-pre-activate"></a>The "pre-activate" signal</h3>
<a class="indexterm" name="id3367241"></a><pre class="programlisting">void user_function (<a href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a> *action_group,
<a href="GtkAction.html" title="GtkAction">GtkAction</a> *action,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : </pre>
<p>
The pre_activate signal is emitted just before the <em class="parameter"><code>action</code></em> in the
<em class="parameter"><code>action_group</code></em> is activated
</p>
<p>
This is intended for <a href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> to proxy the signal and provide global
notification just before any action is activated.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>action_group</code></em> :</span></td>
<td> the group
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>action</code></em> :</span></td>
<td> the action
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
</div>
</div>
</body>
</html>