* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
- * License along with the Gnome Library; see the file COPYING.LIB. If not,
- * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
/*
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
+/**
+ * SECTION:gtkactiongroup
+ * @Short_description: A group of actions
+ * @Title: GtkActionGroup
+ *
+ * Actions are organised into groups. An action group is essentially a
+ * map from names to #GtkAction objects.
+ *
+ * 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.
+ * </para>
+ * <para id="Action-Accel">
+ * Accelerators are handled by the GTK+ accelerator map. All actions are
+ * assigned an accelerator path (which normally has the form
+ * <literal><Actions>/group-name/action-name</literal>)
+ * 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.
+ *
+ * <refsect2 id="GtkActionGroup-BUILDER-UI">
+ * <title>GtkActionGroup as GtkBuildable</title>
+ * <para>
+ * The #GtkActionGroup implementation of the #GtkBuildable interface accepts
+ * #GtkAction objects as <child> elements in UI definitions.
+ *
+ * Note that it is probably more common to define actions and action groups
+ * in the code, since they are directly related to what the code can do.
+ *
+ * The GtkActionGroup implementation of the GtkBuildable interface supports
+ * a custom <accelerator> element, which has attributes named key and
+ * modifiers and allows to specify accelerators. This is similar to the
+ * <accelerator> element of #GtkWidget, the main difference is that
+ * it doesn't allow you to specify a signal.
+ * </para>
+ * <example>
+ * <title>A #GtkDialog UI definition fragment.</title>
+ * <programlisting><![CDATA[
+ * <object class="GtkActionGroup" id="actiongroup">
+ * <child>
+ * <object class="GtkAction" id="About">
+ * <property name="name">About</property>
+ * <property name="stock_id">gtk-about</property>
+ * <signal handler="about_activate" name="activate"/>
+ * </object>
+ * <accelerator key="F1" modifiers="GDK_CONTROL_MASK | GDK_SHIFT_MASK"/>
+ * </child>
+ * </object>
+ * ]]></programlisting>
+ * </example>
+ * </refsect2>
+ */
+
#include "config.h"
#include <string.h>
#include "gtkbuilderprivate.h"
#include "gtkprivate.h"
#include "gtkintl.h"
-#include "gtkalias.h"
-#define GTK_ACTION_GROUP_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_ACTION_GROUP, GtkActionGroupPrivate))
struct _GtkActionGroupPrivate
{
(GInstanceInitFunc) gtk_action_group_init,
};
- static const GInterfaceInfo buildable_info =
+ const GInterfaceInfo buildable_info =
{
(GInterfaceInitFunc) gtk_action_group_buildable_init,
NULL,
* @action: the action
* @proxy: the proxy
*
- * The connect_proxy signal is emitted after connecting a proxy to
+ * 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.
*
* Since: 2.4
*/
action_group_signals[CONNECT_PROXY] =
- g_signal_new (I_("connect_proxy"),
+ g_signal_new (I_("connect-proxy"),
G_OBJECT_CLASS_TYPE (klass),
0, 0, NULL, NULL,
_gtk_marshal_VOID__OBJECT_OBJECT,
* @action: the action
* @proxy: the proxy
*
- * The disconnect_proxy signal is emitted after disconnecting a proxy
+ * The ::disconnect-proxy signal is emitted after disconnecting a proxy
* from an action in the group.
*
* #GtkUIManager proxies the signal and provides global notification
* Since: 2.4
*/
action_group_signals[DISCONNECT_PROXY] =
- g_signal_new (I_("disconnect_proxy"),
+ g_signal_new (I_("disconnect-proxy"),
G_OBJECT_CLASS_TYPE (klass),
0, 0, NULL, NULL,
_gtk_marshal_VOID__OBJECT_OBJECT,
* @action_group: the group
* @action: the action
*
- * The pre_activate signal is emitted just before the @action in the
+ * The ::pre-activate signal is emitted just before the @action in the
* @action_group is activated
*
* This is intended for #GtkUIManager to proxy the signal and provide global
* Since: 2.4
*/
action_group_signals[PRE_ACTIVATE] =
- g_signal_new (I_("pre_activate"),
+ g_signal_new (I_("pre-activate"),
G_OBJECT_CLASS_TYPE (klass),
0, 0, NULL, NULL,
_gtk_marshal_VOID__OBJECT,
* @action_group: the group
* @action: the action
*
- * The post_activate signal is emitted just after the @action in the
+ * The ::post-activate signal is emitted just after the @action in the
* @action_group is activated
*
* This is intended for #GtkUIManager to proxy the signal and provide global
* Since: 2.4
*/
action_group_signals[POST_ACTIVATE] =
- g_signal_new (I_("post_activate"),
+ g_signal_new (I_("post-activate"),
G_OBJECT_CLASS_TYPE (klass),
0, 0, NULL, NULL,
_gtk_marshal_VOID__OBJECT,
}
static void
-gtk_action_group_init (GtkActionGroup *self)
+gtk_action_group_init (GtkActionGroup *action_group)
{
GtkActionGroupPrivate *private;
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ action_group->priv = G_TYPE_INSTANCE_GET_PRIVATE (action_group,
+ GTK_TYPE_ACTION_GROUP,
+ GtkActionGroupPrivate);
+ private = action_group->priv;
private->name = NULL;
private->sensitive = TRUE;
const gchar *name)
{
GtkActionGroup *self = GTK_ACTION_GROUP (buildable);
- GtkActionGroupPrivate *private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ GtkActionGroupPrivate *private = self->priv;
private->name = g_strdup (name);
}
gtk_action_group_buildable_get_name (GtkBuildable *buildable)
{
GtkActionGroup *self = GTK_ACTION_GROUP (buildable);
- GtkActionGroupPrivate *private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ GtkActionGroupPrivate *private = self->priv;
+
return private->name;
}
data = (AcceleratorParserData*)user_data;
action_group = GTK_ACTION_GROUP (buildable);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
action = GTK_ACTION (child);
accel_path = g_strconcat ("<Actions>/",
GtkActionGroupPrivate *private;
self = g_object_new (GTK_TYPE_ACTION_GROUP, NULL);
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ private = self->priv;
private->name = g_strdup (name);
return self;
GtkActionGroupPrivate *private;
self = GTK_ACTION_GROUP (object);
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ private = self->priv;
g_free (private->name);
private->name = NULL;
gchar *tmp;
self = GTK_ACTION_GROUP (object);
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ private = self->priv;
switch (prop_id)
{
GtkActionGroupPrivate *private;
self = GTK_ACTION_GROUP (object);
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ private = self->priv;
switch (prop_id)
{
{
GtkActionGroupPrivate *private;
- private = GTK_ACTION_GROUP_GET_PRIVATE (self);
+ private = self->priv;
return g_hash_table_lookup (private->actions, action_name);
}
*
* Since: 2.4
*/
-G_CONST_RETURN gchar *
+const gchar *
gtk_action_group_get_name (GtkActionGroup *action_group)
{
GtkActionGroupPrivate *private;
g_return_val_if_fail (GTK_IS_ACTION_GROUP (action_group), NULL);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
return private->name;
}
g_return_val_if_fail (GTK_IS_ACTION_GROUP (action_group), FALSE);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
return private->sensitive;
}
{
/* Minor optimization, the action_groups state only affects actions
* that are themselves sensitive */
- if (gtk_action_get_sensitive (action))
- _gtk_action_sync_sensitive (action);
+ g_object_notify (G_OBJECT (action), "sensitive");
+
}
/**
g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
sensitive = sensitive != FALSE;
if (private->sensitive != sensitive)
g_return_val_if_fail (GTK_IS_ACTION_GROUP (action_group), FALSE);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
return private->visible;
}
{
/* Minor optimization, the action_groups state only affects actions
* that are themselves visible */
- if (gtk_action_get_visible (action))
- _gtk_action_sync_visible (action);
+ g_object_notify (G_OBJECT (action), "visible");
}
/**
g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
visible = visible != FALSE;
if (private->visible != visible)
*
* Looks up an action in the action group by name.
*
- * Returns: the action, or %NULL if no action by that name exists
+ * Returns: (transfer none): the action, or %NULL if no action by that name exists
*
* Since: 2.4
*/
g_return_val_if_fail (GTK_IS_ACTION_GROUP (action_group), NULL);
g_return_val_if_fail (GTK_ACTION_GROUP_GET_CLASS (action_group)->get_action != NULL, NULL);
- return (* GTK_ACTION_GROUP_GET_CLASS (action_group)->get_action)
- (action_group, action_name);
+ return GTK_ACTION_GROUP_GET_CLASS (action_group)->get_action (action_group,
+ action_name);
}
static gboolean
{
GtkActionGroupPrivate *private;
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
g_warning ("Refusing to add non-unique action '%s' to action group '%s'",
action_name,
if (!check_unique_action (action_group, name))
return;
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
g_hash_table_insert (private->actions,
(gpointer) name,
/**
* gtk_action_group_add_action_with_accel:
- * @action_group: the action group
- * @action: the action to add
- * @accelerator: the accelerator for the action, in
- * the format understood by gtk_accelerator_parse(), or "" for no accelerator, or
- * %NULL to use the stock accelerator
+ * @action_group: the action group
+ * @action: the action to add
+ * @accelerator: (allow-none): the accelerator for the action, in
+ * the format understood by gtk_accelerator_parse(), or "" for no accelerator, or
+ * %NULL to use the stock accelerator
*
* Adds an action object to the action group and sets up the accelerator.
*
if (!check_unique_action (action_group, name))
return;
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
accel_path = g_strconcat ("<Actions>/",
private->name, "/", name, NULL);
name = gtk_action_get_name (action);
g_return_if_fail (name != NULL);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
g_hash_table_remove (private->actions, name);
}
*
* Lists the actions in the action group.
*
- * Returns: an allocated list of the action objects in the action group
- *
+ * Returns: (element-type GtkAction) (transfer container): an allocated list of the action objects in the action group
+ *
* Since: 2.4
*/
GList *
g_return_val_if_fail (GTK_IS_ACTION_GROUP (action_group), NULL);
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
g_hash_table_foreach (private->actions, add_single_action, &actions);
/**
- * gtk_action_group_add_actions:
+ * gtk_action_group_add_actions: (skip)
* @action_group: the action group
- * @entries: an array of action descriptions
+ * @entries: (array length=n_entries): an array of action descriptions
* @n_entries: the number of entries
* @user_data: data to pass to the action callbacks
*
shared_data->ref_count--;
if (shared_data->ref_count == 0)
{
- if (shared_data->destroy)
- (*shared_data->destroy) (shared_data->data);
-
+ if (shared_data->destroy)
+ shared_data->destroy (shared_data->data);
+
g_slice_free (SharedData, shared_data);
}
}
/**
- * gtk_action_group_add_actions_full:
+ * gtk_action_group_add_actions_full: (skip)
* @action_group: the action group
- * @entries: an array of action descriptions
+ * @entries: (array length=n_entries): an array of action descriptions
* @n_entries: the number of entries
* @user_data: data to pass to the action callbacks
* @destroy: destroy notification callback for @user_data
}
/**
- * gtk_action_group_add_toggle_actions:
+ * gtk_action_group_add_toggle_actions: (skip)
* @action_group: the action group
- * @entries: an array of toggle action descriptions
+ * @entries: (array length=n_entries): an array of toggle action descriptions
* @n_entries: the number of entries
* @user_data: data to pass to the action callbacks
*
/**
- * gtk_action_group_add_toggle_actions_full:
+ * gtk_action_group_add_toggle_actions_full: (skip)
* @action_group: the action group
- * @entries: an array of toggle action descriptions
+ * @entries: (array length=n_entries): an array of toggle action descriptions
* @n_entries: the number of entries
* @user_data: data to pass to the action callbacks
* @destroy: destroy notification callback for @user_data
}
/**
- * gtk_action_group_add_radio_actions:
+ * gtk_action_group_add_radio_actions: (skip)
* @action_group: the action group
- * @entries: an array of radio action descriptions
+ * @entries: (array length=n_entries): an array of radio action descriptions
* @n_entries: the number of entries
* @value: the value of the action to activate initially, or -1 if
* no action should be activated
}
/**
- * gtk_action_group_add_radio_actions_full:
+ * gtk_action_group_add_radio_actions_full: (skip)
* @action_group: the action group
- * @entries: an array of radio action descriptions
+ * @entries: (array length=n_entries): an array of radio action descriptions
* @n_entries: the number of entries
* @value: the value of the action to activate initially, or -1 if
* no action should be activated
g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
if (private->translate_notify)
private->translate_notify (private->translate_data);
/**
* gtk_action_group_set_translation_domain:
* @action_group: a #GtkActionGroup
- * @domain: the translation domain to use for g_dgettext() calls
+ * @domain: (allow-none): the translation domain to use for g_dgettext()
+ * calls, or %NULL to use the domain set with textdomain()
*
* Sets the translation domain and uses g_dgettext() for translating the
* @label and @tooltip of #GtkActionEntry<!-- -->s added by
*
* Since: 2.6
**/
-G_CONST_RETURN gchar *
+const gchar *
gtk_action_group_translate_string (GtkActionGroup *action_group,
const gchar *string)
{
if (string == NULL)
return NULL;
- private = GTK_ACTION_GROUP_GET_PRIVATE (action_group);
+ private = action_group->priv;
translate_func = private->translate_func;
translate_data = private->translate_data;
{
g_signal_emit (action_group, action_group_signals[POST_ACTIVATE], 0, action);
}
-
-#define __GTK_ACTION_GROUP_C__
-#include "gtkaliasdef.c"