Top |
gchar *
amtk_utils_remove_mnemonic (const gchar *str
);
Removes the mnemonics from str
. Single underscores are removed, and two
consecutive underscores are replaced by one underscore (see the documentation
of gtk_label_new_with_mnemonic()
).
the new string with the mnemonics removed. Free
with g_free()
when no longer needed.
[transfer full]
Since: 5.0
gchar * amtk_utils_recent_chooser_menu_get_item_uri (GtkRecentChooserMenu *menu
,GtkMenuItem *item
);
Gets the URI of item
. item
must be a child of menu
. menu
must be a
GtkRecentChooserMenu.
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.
Since: 2.0
void amtk_utils_bind_g_action_to_gtk_action (GActionMap *g_action_map
,const gchar *detailed_g_action_name_without_prefix
,GtkActionGroup *gtk_action_group
,const gchar *gtk_action_name
);
Utility function to be able to port an application gradually to GAction, when GtkUIManager and GtkAction are still used. Porting to GAction should be the first step.
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 “activate” signal
is emitted.
Binds the GAction “enabled” property to the 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.
g_action_map |
a GActionMap. |
|
detailed_g_action_name_without_prefix |
a detailed GAction name without the
GActionMap prefix; the GAction must be present in |
|
gtk_action_group |
||
gtk_action_name |
a GtkAction name present in |
Since: 4.0
void amtk_utils_create_gtk_action (GActionMap *g_action_map
,const gchar *detailed_g_action_name_with_prefix
,GtkActionGroup *gtk_action_group
,const gchar *gtk_action_name
);
Utility function to be able to port an application gradually to GAction and
AmtkActionInfo, when GtkUIManager is still used. This function goes one
step further compared to amtk_utils_bind_g_action_to_gtk_action()
. With
amtk_utils_bind_g_action_to_gtk_action()
, only the GAction must exist. With
amtk_utils_create_gtk_action()
, both the GAction and AmtkActionInfo must
exist (so typically you need to convert the GtkActionEntry's into
AmtkActionInfoEntry's).
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.
g_action_map |
a GActionMap. |
|
detailed_g_action_name_with_prefix |
a detailed GAction name with the
GActionMap prefix; the GAction must be present in |
|
gtk_action_group |
||
gtk_action_name |
the name of the GtkAction to create and add to
|
Since: 4.0
GtkWidget *
amtk_utils_get_shrinkable_menubar (GtkMenuBar *menubar
);
This function wraps menubar
into a container, to allow the menubar to shrink
below its minimum width.
A possible use-case: have two applications side-by-side on a single screen.
Since: 5.6