Back to Seed Clases

Gtk

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Gtk.ActionGroup

Class Gtk.ActionGroup

Import line:	Gtk = imports.gi.Gtk;
GIR File:	Gtk-3.0.gir
C documentation:	GtkActionGroup
Class :	ActionGroup
Implements:	Gtk.Buildable
Extends:	GObject.Object

Actions are organised into groups. An action group is essentially a
map from names to GtkAction objects.
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.

Accelerators are handled by the GTK+ accelerator map. All actions are
assigned an accelerator path (which normally has the form
<Actions>/group-name/action-name)
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.

GtkActionGroup as GtkBuildable

The GtkActionGroup implementation of the GtkBuildable interface accepts
GtkAction objects as <child> elements in UI definitions.
Note that it is probably more common to define actions and action groups
in the code, since they are directly related to what the code can do.
The GtkActionGroup implementation of the GtkBuildable interface supports
a custom <accelerator> element, which has attributes named key and
modifiers and allows to specify accelerators. This is similar to the
<accelerator> element of GtkWidget, the main difference is that
it doesn't allow you to specify a signal.

A <b>GtkDialog</b> UI definition fragment.

]]>

Properties
Properties		Defined By
	name : String	Gtk.ActionGroup
	parent : GObject.Object read only	Gtk.ActionGroup
	priv : Gtk.ActionGroupPrivate read only	Gtk.ActionGroup
	sensitive : gboolean	Gtk.ActionGroup
	visible : gboolean	Gtk.ActionGroup

Methods / Constructors
Method / Constructor		Defined By
	new Gtk.ActionGroup (Object *properties) Create a new Gtk.ActionGroup Create a new Gtk.ActionGroup Parameters: Object properties*
	new Gtk.ActionGroup.c_new (String *name) : Gtk.ActionGroup Create a new Gtk.ActionGroup Create a new Gtk.ActionGroup Parameters: String name* Required (not null) the name of the action group. Returns: Gtk.ActionGroup the new GtkActionGroup
	add_action (Action *action) : none Adds an action object to the action group. Adds an action object to the action group. Note that this function does not set up the accel path of the action, which can lead to problems if a user tries to modify the accelerator of a menuitem associated with the action. Therefore you must either set the accel path yourself with gtk_action_set_accel_path(), or use gtk_action_group_add_action_with_accel (..., NULL). Parameters: Gtk.Action action* Required (not null) an action Returns: none	Gtk.ActionGroup
	add_action_with_accel (Action *action, String accelerator) : none Adds an action object to the action group and sets up the accelerator. Adds an action object to the action group and sets up the accelerator. If accelerator* is NULL, attempts to use the accelerator associated with the stock_id of the action. Accel paths are set to <Actions>/group-name/action-name. Parameters: Gtk.Action action Required (not null) the action to add String accelerator the accelerator for the action, in the format understood by gtk_accelerator_parse(), or "" for no accelerator, or NULL to use the stock accelerator Returns: none	Gtk.ActionGroup
	add_child (Builder *builder, Object child, String type) : none Adds a child to buildable. Adds a child to buildable. type* is an optional string describing how the child should be added. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder GObject.Object child Required (not null) child to add String type kind of child or NULL Returns: none	Gtk.Buildable
	construct_child (Builder *builder, String name) : GObject.Object Constructs a child of buildable* with the name name. Constructs a child of buildable with the name name. GtkBuilder calls this function if a "constructor" has been specified in the UI definition. Parameters: Gtk.Builder builder Required (not null) GtkBuilder used to construct this object String name Required (not null) name of child to construct Returns: GObject.Object the constructed child	Gtk.Buildable
	custom_finished (Builder *builder, Object child, String tagname, void *data) : none This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable. This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder GObject.Object child child object or NULL for non-child tags String tagname Required (not null) the name of the tag void* data Required (not null) user data created in custom_tag_start Returns: none	Gtk.Buildable
	custom_tag_end (Builder *builder, Object child, String tagname, void *data) : none This is called at the end of each custom element handled by the buildable. This is called at the end of each custom element handled by the buildable. Parameters: Gtk.Builder builder* Required (not null) GtkBuilder used to construct this object GObject.Object child child object or NULL for non-child tags String tagname Required (not null) name of tag void* data Required (not null) user data that will be passed in to parser functions Returns: none	Gtk.Buildable
	custom_tag_start (Builder *builder, Object child, String tagname, Object out_values) : gboolean This is called for each unknown element under <child>. This is called for each unknown element under <child>. if it doesn't. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder used to construct this object GObject.Object child child object or NULL for non-child tags String tagname Required (not null) name of tag Object out_values GLib.MarkupParser parser void* data Returns: gboolean TRUE if a object has a custom implementation, FALSE	Gtk.Buildable
	get_action (String *action_name) : Gtk.Action Looks up an action in the action group by name. Looks up an action in the action group by name. Parameters: String action_name* Required (not null) the name of the action Returns: Gtk.Action the action, or NULL if no action by that name exists	Gtk.ActionGroup
	get_internal_child (Builder *builder, String childname) : GObject.Object Get the internal child called childname* of the buildable object. Get the internal child called childname of the buildable object. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder String childname Required (not null) name of child Returns: GObject.Object the internal child of the buildable object	Gtk.Buildable
	get_name () : String Gets the name of the action group. Gets the name of the action group. Returns: String the name of the action group.	Gtk.ActionGroup
	get_sensitive () : gboolean Returns TRUE if the group is sensitive. Returns TRUE if the group is sensitive. The constituent actions can only be logically sensitive (see gtk_action_is_sensitive()) if they are sensitive (see gtk_action_get_sensitive()) and their group is sensitive. Returns: gboolean TRUE if the group is sensitive.	Gtk.ActionGroup
	get_visible () : gboolean Returns TRUE if the group is visible. Returns TRUE if the group is visible. The constituent actions can only be logically visible (see gtk_action_is_visible()) if they are visible (see gtk_action_get_visible()) and their group is visible. Returns: gboolean TRUE if the group is visible.	Gtk.ActionGroup
	list_actions () : Array Lists the actions in the action group. Lists the actions in the action group. Returns: Array an allocated list of the action objects in the action group	Gtk.ActionGroup
	parser_finished (Builder *builder) : none Called when the builder finishes the parsing of a GtkBuilder UI definition. Called when the builder finishes the parsing of a GtkBuilder UI definition. Note that this will be called once for each time gtk_builder_add_from_file() or gtk_builder_add_from_string() is called on a builder. Parameters: Gtk.Builder builder* Required (not null) a GtkBuilder Returns: none	Gtk.Buildable
	remove_action (Action *action) : none Removes an action object from the action group. Removes an action object from the action group. Parameters: Gtk.Action action* Required (not null) an action Returns: none	Gtk.ActionGroup
	set_buildable_property (Builder *builder, String name, Value value) : none Sets the property name name* to value on the buildable object. Sets the property name name to value on the buildable object. Parameters: Gtk.Builder builder Required (not null) a GtkBuilder String name Required (not null) name of property GObject.Value value Required (not null) value of property Returns: none	Gtk.Buildable
	set_name (String *name) : none Sets the name of the buildable* object. Sets the name of the buildable object. Parameters: String name Required (not null) name to set Returns: none	Gtk.Buildable
	set_sensitive (gboolean *sensitive) : none Changes the sensitivity of action_group* Changes the sensitivity of action_group Parameters: gboolean sensitive Required (not null) new sensitivity Returns: none	Gtk.ActionGroup
	set_translate_func (Function *func, void *data, Function notify) : none Sets a function to be used for translating the label* and tooltip of GtkActionGroupEntrys added by gtk_action_group_add_actions(). Sets a function to be used for translating the label and tooltip of GtkActionGroupEntrys added by gtk_action_group_add_actions(). If you're using gettext(), it is enough to set the translation domain with gtk_action_group_set_translation_domain(). Parameters: Function (String *path, void *func_data) : none Required (not null) a GtkTranslateFunc* void* data Required (not null) data to be passed to func and notify Function (void* *data) : none Required (not null) a GDestroyNotify* function to be called when action_group is destroyed and when the translation function is changed again Returns: none	Gtk.ActionGroup
	set_translation_domain (String *domain) : none Sets the translation domain and uses g_dgettext() for translating the gtk_action_group_add_actions(). Sets the translation domain and uses g_dgettext() for translating the gtk_action_group_add_actions(). If you're not using gettext() for localization, see gtk_action_group_set_translate_func(). Parameters: String domain* Required (not null) the translation domain to use for g_dgettext() calls Returns: none	Gtk.ActionGroup
	set_visible (gboolean *visible) : none Changes the visible of action_group. Changes the visible of action_group. Parameters: gboolean visible* Required (not null) new visiblity Returns: none	Gtk.ActionGroup
	translate_string (String *string) : String Translates a string using the specified translate_func(). Translates a string using the specified translate_func(). This is mainly intended for language bindings. Parameters: String string* Required (not null) a string Returns: String the translation of string	Gtk.ActionGroup

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	connect_proxy (ActionGroup *self, Action action, Widget proxy) : none The ::connect-proxy signal is emitted after connecting a proxy to an action in the group. The ::connect-proxy signal is emitted after connecting a proxy to an action in the group. Note that the proxy may have been connected to a different action before. This is intended for simple customizations for which a custom action class would be too clumsy, e.g. showing tooltips for menuitems in the statusbar. GtkUIManager* proxies the signal and provides global notification just before any action is connected to a proxy, which is probably more convenient to use. Parameters: Gtk.ActionGroup self Gtk.Action action Gtk.Widget proxy Returns: {none}	Gtk.ActionGroup
	disconnect_proxy (ActionGroup *self, Action action, Widget proxy) : none The ::disconnect-proxy signal is emitted after disconnecting a proxy from an action in the group. The ::disconnect-proxy signal is emitted after disconnecting a proxy from an action in the group. GtkUIManager* proxies the signal and provides global notification just before any action is connected to a proxy, which is probably more convenient to use. Parameters: Gtk.ActionGroup self Gtk.Action action Gtk.Widget proxy Returns: {none}	Gtk.ActionGroup
	post_activate (ActionGroup *self, Action action) : none The ::post-activate signal is emitted just after the action* in the This is intended for GtkUIManager to proxy the signal and provide global notification just after any action is activated. The ::post-activate signal is emitted just after the action in the This is intended for GtkUIManager to proxy the signal and provide global notification just after any action is activated. Parameters: Gtk.ActionGroup self Gtk.Action action Returns: {none}	Gtk.ActionGroup
	pre_activate (ActionGroup *self, Action action) : none The ::pre-activate signal is emitted just before the action* in the This is intended for GtkUIManager to proxy the signal and provide global notification just before any action is activated. The ::pre-activate signal is emitted just before the action in the This is intended for GtkUIManager to proxy the signal and provide global notification just before any action is activated. Parameters: Gtk.ActionGroup self Gtk.Action action Returns: {none}	Gtk.ActionGroup

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gtk.Action Property	action_group : Gtk.ActionGroup
Gtk.UIManager Method	insert_action_group (ActionGroup *action_group, gint32 pos) : none Inserts an action group into the list of action groups associated with manager*.
Gtk.UIManager Method	remove_action_group (ActionGroup *action_group) : none Removes an action group from the list of action groups associated with manager*.