GSimpleActionGroup

GSimpleActionGroup — A simple GActionGroup implementation

Synopsis

                    GSimpleActionGroup;

GSimpleActionGroup * g_simple_action_group_new          (void);

GAction *           g_simple_action_group_lookup        (GSimpleActionGroup *simple,
                                                         const gchar *action_name);
void                g_simple_action_group_insert        (GSimpleActionGroup *simple,
                                                         GAction *action);
void                g_simple_action_group_remove        (GSimpleActionGroup *simple,
                                                         const gchar *action_name);

void                g_simple_action_group_add_entries   (GSimpleActionGroup *simple,
                                                         const GActionEntry *entries,
                                                         gint n_entries,
                                                         gpointer user_data);

Object Hierarchy

  GObject
   +----GSimpleActionGroup

Implemented Interfaces

GSimpleActionGroup implements GActionGroup and GActionMap.

Description

GSimpleActionGroup is a hash table filled with GAction objects, implementing the GActionGroup and GActionMap interfaces.

Details

GSimpleActionGroup

typedef struct _GSimpleActionGroup GSimpleActionGroup;

The GSimpleActionGroup structure contains private data and should only be accessed using the provided API.

Since 2.28


g_simple_action_group_new ()

GSimpleActionGroup * g_simple_action_group_new          (void);

Creates a new, empty, GSimpleActionGroup.

Returns :

a new GSimpleActionGroup

Since 2.28


g_simple_action_group_lookup ()

GAction *           g_simple_action_group_lookup        (GSimpleActionGroup *simple,
                                                         const gchar *action_name);

Looks up the action with the name action_name in the group.

If no such action exists, returns NULL.

simple :

a GSimpleActionGroup

action_name :

the name of an action

Returns :

a GAction, or NULL. [transfer none]

Since 2.28


g_simple_action_group_insert ()

void                g_simple_action_group_insert        (GSimpleActionGroup *simple,
                                                         GAction *action);

Adds an action to the action group.

If the action group already contains an action with the same name as action then the old action is dropped from the group.

The action group takes its own reference on action.

simple :

a GSimpleActionGroup

action :

a GAction

Since 2.28


g_simple_action_group_remove ()

void                g_simple_action_group_remove        (GSimpleActionGroup *simple,
                                                         const gchar *action_name);

Removes the named action from the action group.

If no action of this name is in the group then nothing happens.

simple :

a GSimpleActionGroup

action_name :

the name of the action

Since 2.28


g_simple_action_group_add_entries ()

void                g_simple_action_group_add_entries   (GSimpleActionGroup *simple,
                                                         const GActionEntry *entries,
                                                         gint n_entries,
                                                         gpointer user_data);

A convenience function for creating multiple GSimpleAction instances and adding them to the action group.

simple :

a GSimpleActionGroup

entries :

a pointer to the first item in an array of GActionEntry structs. [array length=n_entries]

n_entries :

the length of entries, or -1

user_data :

the user data for signal connections

Since 2.30