Namespace Amtk

This function first checks - for each entry - that the action_map doesn't already contain a #GAction with the same name. A warning is printed if an old action will be dropped. In any case, it then calls g_action_map_add_action_entries() with the same arguments as passed to this function.

This function also checks if there are duplicates in the entries array itself.

It is not mandatory to call this function, it's just to be friendlier to memory debugging tools. This function is meant to be called at the end of main(). It can be called several times.

This function can be called several times, but is meant to be called at the beginning of main(), before any other Amtk function call.

If the child widget of item is already a #GtkBox, all #GtkImage widgets inside that box are first destroyed. A #GtkImage for icon_name is then inserted to the box.

If the child widget of item is not a #GtkBox (it's usually the #GtkAccelLabel), it is replaced by a new #GtkBox and the initial child widget is inserted to the #GtkBox, alongside the icon.

As a consequence, if you want to call functions on the #GtkAccelLabel, it's easier to do it before calling this function.

It is on purpose that the return type is #GtkShortcutsWindow, not #GtkWidget or something else, so in C when you declare the variable as #GtkShortcutsWindow it's easier to find it later (searching "GtkShortcuts" will return something in your codebase).

For detailed_g_action_name_without_prefix, see the g_action_parse_detailed_name() function. The "app." or "win." prefix (or any other #GActionMap prefix) must not be included in detailed_g_action_name_without_prefix. For example a valid detailed_g_action_name_without_prefix is "open" or "insert-command::foobar".

The same #GAction can be bound to several #GtkAction's (with different parameter values for the #GAction), but the reverse is not true, one #GtkAction cannot be bound to several #GAction's.

This function:

• Calls g_action_activate() when the #GtkAction #GtkAction::activate signal is emitted.
• Binds the #GAction #GAction:enabled property to the #GtkAction #GtkAction:sensitive property. The binding is done with the %G_BINDING_BIDIRECTIONAL and %G_BINDING_SYNC_CREATE flags, the source is the #GAction and the target is the #GtkAction.

When using this function, you should set the callback to %NULL in the corresponding #GtkActionEntry.

This function creates a #GtkAction from a #GAction plus its corresponding #AmtkActionInfo.

The #GtkAction is created with the information provided by the #AmtkActionInfo (retrieved with amtk_action_info_central_store_lookup() with detailed_g_action_name_with_prefix as argument). Only the first accelerator is taken into account.

Once the #GtkAction is created, it is added to the gtk_action_group, and amtk_utils_bind_g_action_to_gtk_action() is called.

This function has been written because the value returned by gtk_recent_chooser_get_current_uri() is not updated when #GtkMenuItem's of a #GtkRecentChooserMenu are selected/deselected.