Module: Gio::ActionMap
- Defined in:
- (unknown)
Overview
The GActionMap interface is implemented by GAction::Group implementations that operate by containing a number of named #GAction instances, such as GSimple::ActionGroup.
One useful application of this interface is to map the names of actions from various action groups to unique, prefixed names (e.g. by prepending “app.” or “win.”). This is the motivation for the ‘Map’ part of the interface name.
Instance Method Summary collapse
-
#add_action(action) ⇒ nil
Adds an action to the action_map.
-
#add_action_entries(entries, n_entries, user_data) ⇒ nil
A convenience function for creating multiple GSimple::Action instances and adding them to a GAction::Map.
-
#lookup_action(action_name) ⇒ Gio::Action
Looks up the action with the name action_name in action_map.
-
#remove_action(action_name) ⇒ nil
Removes the named action from the action map.
Instance Method Details
#add_action(action) ⇒ nil
Adds an action to the action_map.
If the action map already contains an action with the same name as action then the old action is dropped from the action map.
The action map takes its own reference on action.
#add_action_entries(entries, n_entries, user_data) ⇒ nil
A convenience function for creating multiple GSimple::Action instances and adding them to a GAction::Map.
Each action is constructed as per one GAction::Entry.
static void
activate_quit (GSimpleAction *simple,
GVariant *parameter,
gpointer user_data)
{
exit (0);
}
static void
activate_print_string (GSimpleAction *simple,
GVariant *parameter,
gpointer user_data)
{
g_print ("%s\n", g_variant_get_string (parameter, NULL));
}
static GActionGroup *
create_action_group (void)
{
const GActionEntry entries[] = {
{ "quit", activate_quit },
{ "print-string", activate_print_string, "s" }
};
GSimpleActionGroup *group;
group = g_simple_action_group_new ();
g_action_map_add_action_entries (G_ACTION_MAP (group), entries, G_N_ELEMENTS (entries), NULL);
return G_ACTION_GROUP (group);
}
#lookup_action(action_name) ⇒ Gio::Action
Looks up the action with the name action_name in action_map.
If no such action exists, returns nil.
#remove_action(action_name) ⇒ nil
Removes the named action from the action map.
If no action of this name is in the map then nothing happens.