Blame gio/gsimpleactiongroup.c

Packit ae235b
/*
Packit ae235b
 * Copyright © 2010 Codethink Limited
Packit ae235b
 *
Packit ae235b
 * This library is free software; you can redistribute it and/or
Packit ae235b
 * modify it under the terms of the GNU Lesser General Public
Packit ae235b
 * License as published by the Free Software Foundation; either
Packit ae235b
 * version 2.1 of the License, or (at your option) any later version.
Packit ae235b
 *
Packit ae235b
 * This library is distributed in the hope that it will be useful,
Packit ae235b
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit ae235b
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit ae235b
 * Lesser General Public License for more details.
Packit ae235b
 *
Packit ae235b
 * You should have received a copy of the GNU Lesser General
Packit ae235b
 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
Packit ae235b
 *
Packit ae235b
 * Authors: Ryan Lortie <desrt@desrt.ca>
Packit ae235b
 */
Packit ae235b
Packit ae235b
#include "config.h"
Packit ae235b
Packit ae235b
#include "gsimpleactiongroup.h"
Packit ae235b
Packit ae235b
#include "gsimpleaction.h"
Packit ae235b
#include "gactionmap.h"
Packit ae235b
#include "gaction.h"
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * SECTION:gsimpleactiongroup
Packit ae235b
 * @title: GSimpleActionGroup
Packit ae235b
 * @short_description: A simple GActionGroup implementation
Packit ae235b
 * @include: gio/gio.h
Packit ae235b
 *
Packit ae235b
 * #GSimpleActionGroup is a hash table filled with #GAction objects,
Packit ae235b
 * implementing the #GActionGroup and #GActionMap interfaces.
Packit ae235b
 **/
Packit ae235b
Packit ae235b
struct _GSimpleActionGroupPrivate
Packit ae235b
{
Packit ae235b
  GHashTable *table;  /* string -> GAction */
Packit ae235b
};
Packit ae235b
Packit ae235b
static void g_simple_action_group_iface_init (GActionGroupInterface *);
Packit ae235b
static void g_simple_action_group_map_iface_init (GActionMapInterface *);
Packit ae235b
G_DEFINE_TYPE_WITH_CODE (GSimpleActionGroup,
Packit ae235b
  g_simple_action_group, G_TYPE_OBJECT,
Packit ae235b
  G_ADD_PRIVATE (GSimpleActionGroup)
Packit ae235b
  G_IMPLEMENT_INTERFACE (G_TYPE_ACTION_GROUP,
Packit ae235b
                         g_simple_action_group_iface_init);
Packit ae235b
  G_IMPLEMENT_INTERFACE (G_TYPE_ACTION_MAP,
Packit ae235b
                         g_simple_action_group_map_iface_init))
Packit ae235b
Packit ae235b
static gchar **
Packit ae235b
g_simple_action_group_list_actions (GActionGroup *group)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (group);
Packit ae235b
  GHashTableIter iter;
Packit ae235b
  gint n, i = 0;
Packit ae235b
  gchar **keys;
Packit ae235b
  gpointer key;
Packit ae235b
Packit ae235b
  n = g_hash_table_size (simple->priv->table);
Packit ae235b
  keys = g_new (gchar *, n + 1);
Packit ae235b
Packit ae235b
  g_hash_table_iter_init (&iter, simple->priv->table);
Packit ae235b
  while (g_hash_table_iter_next (&iter, &key, NULL))
Packit ae235b
    keys[i++] = g_strdup (key);
Packit ae235b
  g_assert_cmpint (i, ==, n);
Packit ae235b
  keys[n] = NULL;
Packit ae235b
Packit ae235b
  return keys;
Packit ae235b
}
Packit ae235b
Packit ae235b
static gboolean
Packit ae235b
g_simple_action_group_query_action (GActionGroup        *group,
Packit ae235b
                                    const gchar         *action_name,
Packit ae235b
                                    gboolean            *enabled,
Packit ae235b
                                    const GVariantType **parameter_type,
Packit ae235b
                                    const GVariantType **state_type,
Packit ae235b
                                    GVariant           **state_hint,
Packit ae235b
                                    GVariant           **state)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (group);
Packit ae235b
  GAction *action;
Packit ae235b
Packit ae235b
  action = g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
Packit ae235b
  if (action == NULL)
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  if (enabled)
Packit ae235b
    *enabled = g_action_get_enabled (action);
Packit ae235b
Packit ae235b
  if (parameter_type)
Packit ae235b
    *parameter_type = g_action_get_parameter_type (action);
Packit ae235b
Packit ae235b
  if (state_type)
Packit ae235b
    *state_type = g_action_get_state_type (action);
Packit ae235b
Packit ae235b
  if (state_hint)
Packit ae235b
    *state_hint = g_action_get_state_hint (action);
Packit ae235b
Packit ae235b
  if (state)
Packit ae235b
    *state = g_action_get_state (action);
Packit ae235b
Packit ae235b
  return TRUE;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_change_state (GActionGroup *group,
Packit ae235b
                                    const gchar  *action_name,
Packit ae235b
                                    GVariant     *value)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (group);
Packit ae235b
  GAction *action;
Packit ae235b
Packit ae235b
  action = g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
Packit ae235b
  if (action == NULL)
Packit ae235b
    return;
Packit ae235b
Packit ae235b
  g_action_change_state (action, value);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_activate (GActionGroup *group,
Packit ae235b
                                const gchar  *action_name,
Packit ae235b
                                GVariant     *parameter)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (group);
Packit ae235b
  GAction *action;
Packit ae235b
Packit ae235b
  action = g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
Packit ae235b
  if (action == NULL)
Packit ae235b
    return;
Packit ae235b
Packit ae235b
  g_action_activate (action, parameter);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
action_enabled_notify (GAction     *action,
Packit ae235b
                       GParamSpec  *pspec,
Packit ae235b
                       gpointer     user_data)
Packit ae235b
{
Packit ae235b
  g_action_group_action_enabled_changed (user_data,
Packit ae235b
                                         g_action_get_name (action),
Packit ae235b
                                         g_action_get_enabled (action));
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
action_state_notify (GAction    *action,
Packit ae235b
                     GParamSpec *pspec,
Packit ae235b
                     gpointer    user_data)
Packit ae235b
{
Packit ae235b
  GVariant *value;
Packit ae235b
Packit ae235b
  value = g_action_get_state (action);
Packit ae235b
  g_action_group_action_state_changed (user_data,
Packit ae235b
                                       g_action_get_name (action),
Packit ae235b
                                       value);
Packit ae235b
  g_variant_unref (value);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_disconnect (gpointer key,
Packit ae235b
                                  gpointer value,
Packit ae235b
                                  gpointer user_data)
Packit ae235b
{
Packit ae235b
  g_signal_handlers_disconnect_by_func (value, action_enabled_notify,
Packit ae235b
                                        user_data);
Packit ae235b
  g_signal_handlers_disconnect_by_func (value, action_state_notify,
Packit ae235b
                                        user_data);
Packit ae235b
}
Packit ae235b
Packit ae235b
static GAction *
Packit ae235b
g_simple_action_group_lookup_action (GActionMap *action_map,
Packit ae235b
                                     const gchar        *action_name)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (action_map);
Packit ae235b
Packit ae235b
  return g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_add_action (GActionMap *action_map,
Packit ae235b
                                  GAction    *action)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (action_map);
Packit ae235b
  const gchar *action_name;
Packit ae235b
  GAction *old_action;
Packit ae235b
Packit ae235b
  action_name = g_action_get_name (action);
Packit ae235b
  if (action_name == NULL)
Packit ae235b
    {
Packit ae235b
      g_critical ("The supplied action has no name. You must set the "
Packit ae235b
                  "GAction:name property when creating an action.");
Packit ae235b
      return;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  old_action = g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
Packit ae235b
  if (old_action != action)
Packit ae235b
    {
Packit ae235b
      if (old_action != NULL)
Packit ae235b
        {
Packit ae235b
          g_action_group_action_removed (G_ACTION_GROUP (simple),
Packit ae235b
                                         action_name);
Packit ae235b
          g_simple_action_group_disconnect (NULL, old_action, simple);
Packit ae235b
        }
Packit ae235b
Packit ae235b
      g_signal_connect (action, "notify::enabled",
Packit ae235b
                        G_CALLBACK (action_enabled_notify), simple);
Packit ae235b
Packit ae235b
      if (g_action_get_state_type (action) != NULL)
Packit ae235b
        g_signal_connect (action, "notify::state",
Packit ae235b
                          G_CALLBACK (action_state_notify), simple);
Packit ae235b
Packit ae235b
      g_hash_table_insert (simple->priv->table,
Packit ae235b
                           g_strdup (action_name),
Packit ae235b
                           g_object_ref (action));
Packit ae235b
Packit ae235b
      g_action_group_action_added (G_ACTION_GROUP (simple), action_name);
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_remove_action (GActionMap  *action_map,
Packit ae235b
                                     const gchar *action_name)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (action_map);
Packit ae235b
  GAction *action;
Packit ae235b
Packit ae235b
  action = g_hash_table_lookup (simple->priv->table, action_name);
Packit ae235b
Packit ae235b
  if (action != NULL)
Packit ae235b
    {
Packit ae235b
      g_action_group_action_removed (G_ACTION_GROUP (simple), action_name);
Packit ae235b
      g_simple_action_group_disconnect (NULL, action, simple);
Packit ae235b
      g_hash_table_remove (simple->priv->table, action_name);
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_finalize (GObject *object)
Packit ae235b
{
Packit ae235b
  GSimpleActionGroup *simple = G_SIMPLE_ACTION_GROUP (object);
Packit ae235b
Packit ae235b
  g_hash_table_foreach (simple->priv->table,
Packit ae235b
                        g_simple_action_group_disconnect,
Packit ae235b
                        simple);
Packit ae235b
  g_hash_table_unref (simple->priv->table);
Packit ae235b
Packit ae235b
  G_OBJECT_CLASS (g_simple_action_group_parent_class)
Packit ae235b
    ->finalize (object);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_init (GSimpleActionGroup *simple)
Packit ae235b
{
Packit ae235b
  simple->priv = g_simple_action_group_get_instance_private (simple);
Packit ae235b
  simple->priv->table = g_hash_table_new_full (g_str_hash, g_str_equal,
Packit ae235b
                                               g_free, g_object_unref);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_class_init (GSimpleActionGroupClass *class)
Packit ae235b
{
Packit ae235b
  GObjectClass *object_class = G_OBJECT_CLASS (class);
Packit ae235b
Packit ae235b
  object_class->finalize = g_simple_action_group_finalize;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_iface_init (GActionGroupInterface *iface)
Packit ae235b
{
Packit ae235b
  iface->list_actions = g_simple_action_group_list_actions;
Packit ae235b
  iface->query_action = g_simple_action_group_query_action;
Packit ae235b
  iface->change_action_state = g_simple_action_group_change_state;
Packit ae235b
  iface->activate_action = g_simple_action_group_activate;
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_simple_action_group_map_iface_init (GActionMapInterface *iface)
Packit ae235b
{
Packit ae235b
  iface->add_action = g_simple_action_group_add_action;
Packit ae235b
  iface->remove_action = g_simple_action_group_remove_action;
Packit ae235b
  iface->lookup_action = g_simple_action_group_lookup_action;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_simple_action_group_new:
Packit ae235b
 *
Packit ae235b
 * Creates a new, empty, #GSimpleActionGroup.
Packit ae235b
 *
Packit ae235b
 * Returns: a new #GSimpleActionGroup
Packit ae235b
 *
Packit ae235b
 * Since: 2.28
Packit ae235b
 **/
Packit ae235b
GSimpleActionGroup *
Packit ae235b
g_simple_action_group_new (void)
Packit ae235b
{
Packit ae235b
  return g_object_new (G_TYPE_SIMPLE_ACTION_GROUP, NULL);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_simple_action_group_lookup:
Packit ae235b
 * @simple: a #GSimpleActionGroup
Packit ae235b
 * @action_name: the name of an action
Packit ae235b
 *
Packit ae235b
 * Looks up the action with the name @action_name in the group.
Packit ae235b
 *
Packit ae235b
 * If no such action exists, returns %NULL.
Packit ae235b
 *
Packit ae235b
 * Returns: (transfer none): a #GAction, or %NULL
Packit ae235b
 *
Packit ae235b
 * Since: 2.28
Packit ae235b
 *
Packit ae235b
 * Deprecated: 2.38: Use g_action_map_lookup_action()
Packit ae235b
 */
Packit ae235b
GAction *
Packit ae235b
g_simple_action_group_lookup (GSimpleActionGroup *simple,
Packit ae235b
                              const gchar        *action_name)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_SIMPLE_ACTION_GROUP (simple), NULL);
Packit ae235b
Packit ae235b
  return g_action_map_lookup_action (G_ACTION_MAP (simple), action_name);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_simple_action_group_insert:
Packit ae235b
 * @simple: a #GSimpleActionGroup
Packit ae235b
 * @action: a #GAction
Packit ae235b
 *
Packit ae235b
 * Adds an action to the action group.
Packit ae235b
 *
Packit ae235b
 * If the action group already contains an action with the same name as
Packit ae235b
 * @action then the old action is dropped from the group.
Packit ae235b
 *
Packit ae235b
 * The action group takes its own reference on @action.
Packit ae235b
 *
Packit ae235b
 * Since: 2.28
Packit ae235b
 *
Packit ae235b
 * Deprecated: 2.38: Use g_action_map_add_action()
Packit ae235b
 **/
Packit ae235b
void
Packit ae235b
g_simple_action_group_insert (GSimpleActionGroup *simple,
Packit ae235b
                              GAction            *action)
Packit ae235b
{
Packit ae235b
  g_return_if_fail (G_IS_SIMPLE_ACTION_GROUP (simple));
Packit ae235b
Packit ae235b
  g_action_map_add_action (G_ACTION_MAP (simple), action);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_simple_action_group_remove:
Packit ae235b
 * @simple: a #GSimpleActionGroup
Packit ae235b
 * @action_name: the name of the action
Packit ae235b
 *
Packit ae235b
 * Removes the named action from the action group.
Packit ae235b
 *
Packit ae235b
 * If no action of this name is in the group then nothing happens.
Packit ae235b
 *
Packit ae235b
 * Since: 2.28
Packit ae235b
 *
Packit ae235b
 * Deprecated: 2.38: Use g_action_map_remove_action()
Packit ae235b
 **/
Packit ae235b
void
Packit ae235b
g_simple_action_group_remove (GSimpleActionGroup *simple,
Packit ae235b
                              const gchar        *action_name)
Packit ae235b
{
Packit ae235b
  g_return_if_fail (G_IS_SIMPLE_ACTION_GROUP (simple));
Packit ae235b
Packit ae235b
  g_action_map_remove_action (G_ACTION_MAP (simple), action_name);
Packit ae235b
}
Packit ae235b
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_simple_action_group_add_entries:
Packit ae235b
 * @simple: a #GSimpleActionGroup
Packit ae235b
 * @entries: (array length=n_entries): a pointer to the first item in
Packit ae235b
 *           an array of #GActionEntry structs
Packit ae235b
 * @n_entries: the length of @entries, or -1
Packit ae235b
 * @user_data: the user data for signal connections
Packit ae235b
 *
Packit ae235b
 * A convenience function for creating multiple #GSimpleAction instances
Packit ae235b
 * and adding them to the action group.
Packit ae235b
 *
Packit ae235b
 * Since: 2.30
Packit ae235b
 *
Packit ae235b
 * Deprecated: 2.38: Use g_action_map_add_action_entries()
Packit ae235b
 **/
Packit ae235b
void
Packit ae235b
g_simple_action_group_add_entries (GSimpleActionGroup *simple,
Packit ae235b
                                   const GActionEntry *entries,
Packit ae235b
                                   gint                n_entries,
Packit ae235b
                                   gpointer            user_data)
Packit ae235b
{
Packit ae235b
  g_action_map_add_action_entries (G_ACTION_MAP (simple), entries, n_entries, user_data);
Packit ae235b
}