forked from AuroraMiddleware/gtk
543b020fdc
* gtk/gtkaction.h: Apply egtk-format-protos. * gtk/gtkuimanager.c: Doc tweaks. * gtk/tmpl/gtkaction.sgml: * gtk/tmpl/gtkradioaction.sgml: * gtk/tmpl/gtkactiongroup.sgml: * gtk/tmpl/gtkuimanager.sgml: Updates.
240 lines
5.5 KiB
Plaintext
240 lines
5.5 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkActionGroup
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
a group of actions
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
Actions are organised into groups. An action group is essentially a
|
|
map from names to #GtkAction objects.
|
|
</para>
|
|
<para>
|
|
All actions that would make sense to use in a particular context
|
|
should be in a single group. Multiple action groups may be used for a
|
|
particular user interface. In fact, it is expected that most nontrivial
|
|
applications will make use of multiple groups. For example, in an application
|
|
that can edit multiple documents, one group holding global actions
|
|
(e.g. quit, about, new), and one group per document holding actions that
|
|
act on that document (eg. save, cut/copy/paste, etc). Each window's menus
|
|
would be constructed from a combination of two action groups.
|
|
</para>
|
|
<para id="Action-Accel">
|
|
Accelerators are handled by the GTK+ accelerator map. All actions are assigned an
|
|
accelerator path (which normally has the form
|
|
<literal><Actions>/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>)
|
|
and a shortcut is associated with this accelerator path. All menuitems and
|
|
toolitems take on this accelerator path. The GTK+ accelerator map code makes
|
|
sure that the correct shortcut is displayed next to the menu item.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkActionGroup ##### -->
|
|
<para>
|
|
The <structname>GtkActionGroup</structname> struct contains only private
|
|
members and should not be accessed directly.
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_get_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_get_action ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@action_name:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_list_actions ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_action ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@action:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_remove_action ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@action:
|
|
|
|
|
|
<!-- ##### STRUCT GtkActionEntry ##### -->
|
|
<para>
|
|
<structname>GtkActionEntry</structname> structs are used with
|
|
gtk_action_group_add_actions() to construct actions.
|
|
</para>
|
|
|
|
@name: The name of the action.
|
|
@stock_id: The stock id for the action.
|
|
@label: The label for the action. This field should typically be marked for
|
|
translation, see gtk_action_group_set_translation_domain().
|
|
@accelerator: The accelerator for the action, in the format understood by
|
|
gtk_accelerator_parse().
|
|
@tooltip: The tooltip for the action. This field should typically be marked
|
|
for translation, see gtk_action_group_set_translation_domain().
|
|
@callback: The function to call when the action is activated.
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_actions ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@user_data:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_actions_full ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@user_data:
|
|
@destroy:
|
|
|
|
|
|
<!-- ##### STRUCT GtkToggleActionEntry ##### -->
|
|
<para>
|
|
<structname>GtkToggleActionEntry</structname> structs are used with
|
|
gtk_action_group_add_toggle_actions() to construct toggle actions.
|
|
</para>
|
|
|
|
@name: The name of the action.
|
|
@stock_id: The stock id for the action.
|
|
@label: The label for the action. This field should typically be marked for
|
|
translation, see gtk_action_group_set_translation_domain().
|
|
@accelerator: The accelerator for the action, in the format understood by
|
|
gtk_accelerator_parse().
|
|
@tooltip: The tooltip for the action. This field should typically be marked
|
|
for translation, see gtk_action_group_set_translation_domain().
|
|
@callback: The function to call when the action is activated.
|
|
@is_active: The initial state of the toggle action.
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_toggle_actions ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@user_data:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_toggle_actions_full ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@user_data:
|
|
@destroy:
|
|
|
|
|
|
<!-- ##### STRUCT GtkRadioActionEntry ##### -->
|
|
<para>
|
|
<structname>GtkRadioActionEntry</structname> structs are used with
|
|
gtk_action_group_add_radio_actions() to construct groups of radio actions.
|
|
</para>
|
|
|
|
@name: The name of the action.
|
|
@stock_id: The stock id for the action.
|
|
@label: The label for the action. This field should typically be marked for
|
|
translation, see gtk_action_group_set_translation_domain().
|
|
@accelerator: The accelerator for the action, in the format understood by
|
|
gtk_accelerator_parse().
|
|
@tooltip: The tooltip for the action. This field should typically be marked for
|
|
translation, see gtk_action_group_set_translation_domain().
|
|
@value: The value to set on the radio action. See gtk_radio_action_get_current_value().
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_radio_actions ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@value:
|
|
@on_change:
|
|
@user_data:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_add_radio_actions_full ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@entries:
|
|
@n_entries:
|
|
@value:
|
|
@on_change:
|
|
@user_data:
|
|
@destroy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_set_translate_func ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@func:
|
|
@data:
|
|
@notify:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_group_set_translation_domain ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action_group:
|
|
@domain:
|
|
|
|
|