mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-25 15:06:14 +01:00
Merge branch 'port-gactiongroup-comments' into 'main'
Ports the documentation comments in gio/gactiongroup.c to GI-Docgen See merge request GNOME/glib!4002
This commit is contained in:
commit
7ec1d6352e
@ -32,23 +32,23 @@
|
||||
*
|
||||
* Actions can be used to expose functionality in a structured way, either
|
||||
* from one part of a program to another, or to the outside world. Action
|
||||
* groups are often used together with a `GMenuModel` that provides additional
|
||||
* groups are often used together with a [type@Gio.MenuModel] that provides additional
|
||||
* representation data for displaying the actions to the user, e.g. in a menu.
|
||||
*
|
||||
* The main way to interact with the actions in a `GActionGroup` is to
|
||||
* activate them with [method@Gio.ActionGroup.activate_action]. Activating an
|
||||
* action may require a `GVariant` parameter. The required type of the
|
||||
* action may require a [type@GLib.Variant] parameter. The required type of the
|
||||
* parameter can be inquired with [method@Gio.ActionGroup.get_action_parameter_type].
|
||||
* Actions may be disabled, see [method@Gio.ActionGroup.get_action_enabled].
|
||||
* Activating a disabled action has no effect.
|
||||
*
|
||||
* Actions may optionally have a state in the form of a #GVariant. The current
|
||||
* Actions may optionally have a state in the form of a [type@GLib.Variant]. The current
|
||||
* state of an action can be inquired with [method@Gio.ActionGroup.get_action_state].
|
||||
* Activating a stateful action may change its state, but it is also possible to
|
||||
* set the state by calling [method@Gio.ActionGroup.change_action_state].
|
||||
*
|
||||
* As typical example, consider a text editing application which has an
|
||||
* option to change the current font to 'bold'. A good way to represent
|
||||
* option to change the current font to ‘bold’. A good way to represent
|
||||
* this would be a stateful action, with a boolean state. Activating the
|
||||
* action would toggle the state.
|
||||
*
|
||||
@ -56,13 +56,13 @@
|
||||
* method calls, except [method@Gio.ActionGroup.list_actions] take the name of
|
||||
* an action as an argument.
|
||||
*
|
||||
* The `GActionGroup` API is meant to be the 'public' API to the action
|
||||
* group. The calls here are exactly the interaction that 'external
|
||||
* forces' (eg: UI, incoming D-Bus messages, etc.) are supposed to have
|
||||
* with actions. 'Internal' APIs (ie: ones meant only to be accessed by
|
||||
* The `GActionGroup` API is meant to be the ‘public’ API to the action
|
||||
* group. The calls here are exactly the interaction that ‘external
|
||||
* forces’ (eg: UI, incoming D-Bus messages, etc.) are supposed to have
|
||||
* with actions. ‘Internal’ APIs (ie: ones meant only to be accessed by
|
||||
* the action group implementation) are found on subclasses. This is
|
||||
* why you will find - for example - [method@Gio.ActionGroup.get_action_enabled]
|
||||
* but not an equivalent set() call.
|
||||
* why you will find – for example – [method@Gio.ActionGroup.get_action_enabled]
|
||||
* but not an equivalent `set_action_enabled()` method.
|
||||
*
|
||||
* Signals are emitted on the action group in response to state changes
|
||||
* on individual actions.
|
||||
@ -70,28 +70,28 @@
|
||||
* Implementations of `GActionGroup` should provide implementations for
|
||||
* the virtual functions [method@Gio.ActionGroup.list_actions] and
|
||||
* [method@Gio.ActionGroup.query_action]. The other virtual functions should
|
||||
* not be implemented - their "wrappers" are actually implemented with
|
||||
* not be implemented — their ‘wrappers’ are actually implemented with
|
||||
* calls to [method@Gio.ActionGroup.query_action].
|
||||
*/
|
||||
|
||||
/**
|
||||
* GActionGroupInterface:
|
||||
* @has_action: the virtual function pointer for g_action_group_has_action()
|
||||
* @list_actions: the virtual function pointer for g_action_group_list_actions()
|
||||
* @get_action_parameter_type: the virtual function pointer for g_action_group_get_action_parameter_type()
|
||||
* @get_action_state_type: the virtual function pointer for g_action_group_get_action_state_type()
|
||||
* @get_action_state_hint: the virtual function pointer for g_action_group_get_action_state_hint()
|
||||
* @get_action_enabled: the virtual function pointer for g_action_group_get_action_enabled()
|
||||
* @get_action_state: the virtual function pointer for g_action_group_get_action_state()
|
||||
* @change_action_state: the virtual function pointer for g_action_group_change_action_state()
|
||||
* @activate_action: the virtual function pointer for g_action_group_activate_action()
|
||||
* @action_added: the class closure for the #GActionGroup::action-added signal
|
||||
* @action_removed: the class closure for the #GActionGroup::action-removed signal
|
||||
* @action_enabled_changed: the class closure for the #GActionGroup::action-enabled-changed signal
|
||||
* @action_state_changed: the class closure for the #GActionGroup::action-enabled-changed signal
|
||||
* @query_action: the virtual function pointer for g_action_group_query_action()
|
||||
* @has_action: the virtual function pointer for [method@Gio.ActionGroup.has_action]
|
||||
* @list_actions: the virtual function pointer for [method@Gio.ActionGroup.list_actions]
|
||||
* @get_action_parameter_type: the virtual function pointer for [method@Gio.ActionGroup.get_action_parameter_type]
|
||||
* @get_action_state_type: the virtual function pointer for [method@Gio.ActionGroup.get_action_state_type]
|
||||
* @get_action_state_hint: the virtual function pointer for [method@Gio.ActionGroup.get_action_state_hint]
|
||||
* @get_action_enabled: the virtual function pointer for [method@Gio.ActionGroup.get_action_enabled]
|
||||
* @get_action_state: the virtual function pointer for [method@Gio.ActionGroup.get_action_state]
|
||||
* @change_action_state: the virtual function pointer for [method@Gio.ActionGroup.change_action_state]
|
||||
* @activate_action: the virtual function pointer for [method@Gio.ActionGroup.activate_action]
|
||||
* @action_added: the class closure for the [signal@Gio.ActionGroup::action-added] signal
|
||||
* @action_removed: the class closure for the [signal@Gio.ActionGroup::action-removed] signal
|
||||
* @action_enabled_changed: the class closure for the [signal@Gio.ActionGroup::action-enabled-changed] signal
|
||||
* @action_state_changed: the class closure for the [signal@Gio.ActionGroup::action-enabled-changed] signal
|
||||
* @query_action: the virtual function pointer for [method@Gio.ActionGroup.query_action]
|
||||
*
|
||||
* The virtual function table for #GActionGroup.
|
||||
* The virtual function table for [type@Gio.ActionGroup].
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -200,8 +200,8 @@ g_action_group_real_query_action (GActionGroup *action_group,
|
||||
iface->get_action_state_hint == g_action_group_real_get_action_state_hint ||
|
||||
iface->get_action_state == g_action_group_real_get_action_state)
|
||||
{
|
||||
g_critical ("Class '%s' implements GActionGroup interface without overriding "
|
||||
"query_action() method -- bailing out to avoid infinite recursion.",
|
||||
g_critical ("Class ‘%s’ implements GActionGroup interface without overriding "
|
||||
"query_action() method. Bailing out to avoid infinite recursion.",
|
||||
G_OBJECT_TYPE_NAME (action_group));
|
||||
return FALSE;
|
||||
}
|
||||
@ -240,10 +240,11 @@ g_action_group_default_init (GActionGroupInterface *iface)
|
||||
|
||||
/**
|
||||
* GActionGroup::action-added:
|
||||
* @action_group: the #GActionGroup that changed
|
||||
* @action_group: the [type@Gio.ActionGroup] that changed
|
||||
* @action_name: the name of the action in @action_group
|
||||
*
|
||||
* Signals that a new action was just added to the group.
|
||||
*
|
||||
* This signal is emitted after the action has been added
|
||||
* and is now visible.
|
||||
*
|
||||
@ -261,10 +262,11 @@ g_action_group_default_init (GActionGroupInterface *iface)
|
||||
|
||||
/**
|
||||
* GActionGroup::action-removed:
|
||||
* @action_group: the #GActionGroup that changed
|
||||
* @action_group: the [type@Gio.ActionGroup] that changed
|
||||
* @action_name: the name of the action in @action_group
|
||||
*
|
||||
* Signals that an action is just about to be removed from the group.
|
||||
*
|
||||
* This signal is emitted before the action is removed, so the action
|
||||
* is still visible and can be queried from the signal handler.
|
||||
*
|
||||
@ -280,12 +282,11 @@ g_action_group_default_init (GActionGroupInterface *iface)
|
||||
G_TYPE_NONE, 1,
|
||||
G_TYPE_STRING);
|
||||
|
||||
|
||||
/**
|
||||
* GActionGroup::action-enabled-changed:
|
||||
* @action_group: the #GActionGroup that changed
|
||||
* @action_group: the [type@Gio.ActionGroup] that changed
|
||||
* @action_name: the name of the action in @action_group
|
||||
* @enabled: whether the action is enabled or not
|
||||
* @enabled: whether the action is enabled
|
||||
*
|
||||
* Signals that the enabled status of the named action has changed.
|
||||
*
|
||||
@ -308,7 +309,7 @@ g_action_group_default_init (GActionGroupInterface *iface)
|
||||
|
||||
/**
|
||||
* GActionGroup::action-state-changed:
|
||||
* @action_group: the #GActionGroup that changed
|
||||
* @action_group: the [type@Gio.ActionGroup] that changed
|
||||
* @action_name: the name of the action in @action_group
|
||||
* @value: the new value of the state
|
||||
*
|
||||
@ -336,15 +337,15 @@ g_action_group_default_init (GActionGroupInterface *iface)
|
||||
|
||||
/**
|
||||
* g_action_group_list_actions:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
*
|
||||
* Lists the actions contained within @action_group.
|
||||
*
|
||||
* The caller is responsible for freeing the list with g_strfreev() when
|
||||
* The caller is responsible for freeing the list with [func@GLib.strfreev] when
|
||||
* it is no longer required.
|
||||
*
|
||||
* Returns: (transfer full): a %NULL-terminated array of the names of the
|
||||
* actions in the group
|
||||
* Returns: (transfer full) (array zero-terminated=1): a `NULL`-terminated array
|
||||
* of the names of the actions in the group
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -359,7 +360,7 @@ g_action_group_list_actions (GActionGroup *action_group)
|
||||
|
||||
/**
|
||||
* g_action_group_has_action:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to check for
|
||||
*
|
||||
* Checks if the named action exists within @action_group.
|
||||
@ -380,18 +381,18 @@ g_action_group_has_action (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_get_action_parameter_type:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to query
|
||||
*
|
||||
* Queries the type of the parameter that must be given when activating
|
||||
* the named action within @action_group.
|
||||
*
|
||||
* When activating the action using g_action_group_activate_action(),
|
||||
* the #GVariant given to that function must be of the type returned
|
||||
* When activating the action using [method@Gio.ActionGroup.activate_action],
|
||||
* the [type@GLib.Variant] given to that function must be of the type returned
|
||||
* by this function.
|
||||
*
|
||||
* In the case that this function returns %NULL, you must not give any
|
||||
* #GVariant, but %NULL instead.
|
||||
* In the case that this function returns `NULL`, you must not give any
|
||||
* [type@GLib.Variant], but `NULL` instead.
|
||||
*
|
||||
* The parameter type of a particular action will never change but it is
|
||||
* possible for an action to be removed and for a new action to be added
|
||||
@ -413,21 +414,21 @@ g_action_group_get_action_parameter_type (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_get_action_state_type:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to query
|
||||
*
|
||||
* Queries the type of the state of the named action within
|
||||
* @action_group.
|
||||
*
|
||||
* If the action is stateful then this function returns the
|
||||
* #GVariantType of the state. All calls to
|
||||
* g_action_group_change_action_state() must give a #GVariant of this
|
||||
* type and g_action_group_get_action_state() will return a #GVariant
|
||||
* [type@GLib.VariantType] of the state. All calls to
|
||||
* [method@Gio.ActionGroup.change_action_state] must give a [type@GLib.Variant] of this
|
||||
* type and [method@Gio.ActionGroup.get_action_state] will return a [type@GLib.Variant]
|
||||
* of the same type.
|
||||
*
|
||||
* If the action is not stateful then this function will return %NULL.
|
||||
* In that case, g_action_group_get_action_state() will return %NULL
|
||||
* and you must not call g_action_group_change_action_state().
|
||||
* If the action is not stateful then this function will return `NULL`.
|
||||
* In that case, [method@Gio.ActionGroup.get_action_state] will return `NULL`
|
||||
* and you must not call [method@Gio.ActionGroup.change_action_state].
|
||||
*
|
||||
* The state type of a particular action will never change but it is
|
||||
* possible for an action to be removed and for a new action to be added
|
||||
@ -449,18 +450,18 @@ g_action_group_get_action_state_type (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_get_action_state_hint:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to query
|
||||
*
|
||||
* Requests a hint about the valid range of values for the state of the
|
||||
* named action within @action_group.
|
||||
*
|
||||
* If %NULL is returned it either means that the action is not stateful
|
||||
* If `NULL` is returned it either means that the action is not stateful
|
||||
* or that there is no hint about the valid range of values for the
|
||||
* state of the action.
|
||||
*
|
||||
* If a #GVariant array is returned then each item in the array is a
|
||||
* possible value for the state. If a #GVariant pair (ie: two-tuple) is
|
||||
* If a [type@GLib.Variant] array is returned then each item in the array is a
|
||||
* possible value for the state. If a [type@GLib.Variant] pair (ie: two-tuple) is
|
||||
* returned then the tuple specifies the inclusive lower and upper bound
|
||||
* of valid values for the state.
|
||||
*
|
||||
@ -468,8 +469,8 @@ g_action_group_get_action_state_type (GActionGroup *action_group,
|
||||
* have a state value outside of the hinted range and setting a value
|
||||
* within the range may fail.
|
||||
*
|
||||
* The return value (if non-%NULL) should be freed with
|
||||
* g_variant_unref() when it is no longer required.
|
||||
* The return value (if non-`NULL`) should be freed with
|
||||
* [method@GLib.Variant.unref] when it is no longer required.
|
||||
*
|
||||
* Returns: (nullable) (transfer full): the state range hint
|
||||
*
|
||||
@ -487,7 +488,7 @@ g_action_group_get_action_state_hint (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_get_action_enabled:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to query
|
||||
*
|
||||
* Checks if the named action within @action_group is currently enabled.
|
||||
@ -495,7 +496,7 @@ g_action_group_get_action_state_hint (GActionGroup *action_group,
|
||||
* An action must be enabled in order to be activated or in order to
|
||||
* have its state changed from outside callers.
|
||||
*
|
||||
* Returns: whether or not the action is currently enabled
|
||||
* Returns: whether the action is currently enabled
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -511,17 +512,17 @@ g_action_group_get_action_enabled (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_get_action_state:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to query
|
||||
*
|
||||
* Queries the current state of the named action within @action_group.
|
||||
*
|
||||
* If the action is not stateful then %NULL will be returned. If the
|
||||
* If the action is not stateful then `NULL` will be returned. If the
|
||||
* action is stateful then the type of the return value is the type
|
||||
* given by g_action_group_get_action_state_type().
|
||||
* given by [method@Gio.ActionGroup.get_action_state_type].
|
||||
*
|
||||
* The return value (if non-%NULL) should be freed with
|
||||
* g_variant_unref() when it is no longer required.
|
||||
* The return value (if non-`NULL`) should be freed with
|
||||
* [method@GLib.Variant.unref] when it is no longer required.
|
||||
*
|
||||
* Returns: (nullable) (transfer full): the current state of the action
|
||||
*
|
||||
@ -539,7 +540,7 @@ g_action_group_get_action_state (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_change_action_state:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to request the change on
|
||||
* @value: the new state
|
||||
*
|
||||
@ -547,11 +548,11 @@ g_action_group_get_action_state (GActionGroup *action_group,
|
||||
* changed to @value.
|
||||
*
|
||||
* The action must be stateful and @value must be of the correct type.
|
||||
* See g_action_group_get_action_state_type().
|
||||
* See [method@Gio.ActionGroup.get_action_state_type].
|
||||
*
|
||||
* This call merely requests a change. The action may refuse to change
|
||||
* its state or may change its state to something other than @value.
|
||||
* See g_action_group_get_action_state_hint().
|
||||
* See [method@Gio.ActionGroup.get_action_state_hint].
|
||||
*
|
||||
* If the @value GVariant is floating, it is consumed.
|
||||
*
|
||||
@ -572,7 +573,7 @@ g_action_group_change_action_state (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_activate_action:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of the action to activate
|
||||
* @parameter: (nullable): parameters to the activation
|
||||
*
|
||||
@ -580,35 +581,35 @@ g_action_group_change_action_state (GActionGroup *action_group,
|
||||
*
|
||||
* If the action is expecting a parameter, then the correct type of
|
||||
* parameter must be given as @parameter. If the action is expecting no
|
||||
* parameters then @parameter must be %NULL. See
|
||||
* g_action_group_get_action_parameter_type().
|
||||
* parameters then @parameter must be `NULL`. See
|
||||
* [method@Gio.ActionGroup.get_action_parameter_type].
|
||||
*
|
||||
* If the #GActionGroup implementation supports asynchronous remote
|
||||
* If the [type@Gio.ActionGroup] implementation supports asynchronous remote
|
||||
* activation over D-Bus, this call may return before the relevant
|
||||
* D-Bus traffic has been sent, or any replies have been received. In
|
||||
* order to block on such asynchronous activation calls,
|
||||
* g_dbus_connection_flush() should be called prior to the code, which
|
||||
* [method@Gio.DBusConnection.flush] should be called prior to the code, which
|
||||
* depends on the result of the action activation. Without flushing
|
||||
* the D-Bus connection, there is no guarantee that the action would
|
||||
* have been activated.
|
||||
*
|
||||
* The following code which runs in a remote app instance, shows an
|
||||
* example of a "quit" action being activated on the primary app
|
||||
* instance over D-Bus. Here g_dbus_connection_flush() is called
|
||||
* before `exit()`. Without g_dbus_connection_flush(), the "quit" action
|
||||
* example of a ‘quit’ action being activated on the primary app
|
||||
* instance over D-Bus. Here [method@Gio.DBusConnection.flush] is called
|
||||
* before `exit()`. Without `g_dbus_connection_flush()`, the ‘quit’ action
|
||||
* may fail to be activated on the primary instance.
|
||||
*
|
||||
* |[<!-- language="C" -->
|
||||
* // call "quit" action on primary instance
|
||||
* ```c
|
||||
* // call ‘quit’ action on primary instance
|
||||
* g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL);
|
||||
*
|
||||
* // make sure the action is activated now
|
||||
* g_dbus_connection_flush (...);
|
||||
* g_dbus_connection_flush (…);
|
||||
*
|
||||
* g_debug ("application has been terminated. exiting.");
|
||||
* g_debug ("Application has been terminated. Exiting.");
|
||||
*
|
||||
* exit (0);
|
||||
* ]|
|
||||
* ```
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -626,12 +627,12 @@ g_action_group_activate_action (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_action_added:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of an action in the group
|
||||
*
|
||||
* Emits the #GActionGroup::action-added signal on @action_group.
|
||||
* Emits the [signal@Gio.ActionGroup::action-added] signal on @action_group.
|
||||
*
|
||||
* This function should only be called by #GActionGroup implementations.
|
||||
* This function should only be called by [type@Gio.ActionGroup] implementations.
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -650,12 +651,12 @@ g_action_group_action_added (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_action_removed:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of an action in the group
|
||||
*
|
||||
* Emits the #GActionGroup::action-removed signal on @action_group.
|
||||
* Emits the [signal@Gio.ActionGroup::action-removed] signal on @action_group.
|
||||
*
|
||||
* This function should only be called by #GActionGroup implementations.
|
||||
* This function should only be called by [type@Gio.ActionGroup] implementations.
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -674,13 +675,13 @@ g_action_group_action_removed (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_action_enabled_changed:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of an action in the group
|
||||
* @enabled: whether or not the action is now enabled
|
||||
* @enabled: whether the action is now enabled
|
||||
*
|
||||
* Emits the #GActionGroup::action-enabled-changed signal on @action_group.
|
||||
* Emits the [signal@Gio.ActionGroup::action-enabled-changed] signal on @action_group.
|
||||
*
|
||||
* This function should only be called by #GActionGroup implementations.
|
||||
* This function should only be called by [type@Gio.ActionGroup] implementations.
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -703,13 +704,13 @@ g_action_group_action_enabled_changed (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_action_state_changed:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of an action in the group
|
||||
* @state: the new state of the named action
|
||||
*
|
||||
* Emits the #GActionGroup::action-state-changed signal on @action_group.
|
||||
* Emits the [signal@Gio.ActionGroup::action-state-changed] signal on @action_group.
|
||||
*
|
||||
* This function should only be called by #GActionGroup implementations.
|
||||
* This function should only be called by [type@Gio.ActionGroup] implementations.
|
||||
*
|
||||
* Since: 2.28
|
||||
**/
|
||||
@ -730,29 +731,29 @@ g_action_group_action_state_changed (GActionGroup *action_group,
|
||||
|
||||
/**
|
||||
* g_action_group_query_action:
|
||||
* @action_group: a #GActionGroup
|
||||
* @action_group: a [type@Gio.ActionGroup]
|
||||
* @action_name: the name of an action in the group
|
||||
* @enabled: (out): if the action is presently enabled
|
||||
* @parameter_type: (out) (transfer none) (optional): the parameter type, or %NULL if none needed
|
||||
* @state_type: (out) (transfer none) (optional): the state type, or %NULL if stateless
|
||||
* @state_hint: (out) (optional): the state hint, or %NULL if none
|
||||
* @state: (out) (optional): the current state, or %NULL if stateless
|
||||
* @parameter_type: (out) (transfer none) (optional): the parameter type, or `NULL` if none needed
|
||||
* @state_type: (out) (transfer none) (optional): the state type, or `NULL` if stateless
|
||||
* @state_hint: (out) (optional): the state hint, or `NULL` if none
|
||||
* @state: (out) (optional): the current state, or `NULL` if stateless
|
||||
*
|
||||
* Queries all aspects of the named action within an @action_group.
|
||||
*
|
||||
* This function acquires the information available from
|
||||
* g_action_group_has_action(), g_action_group_get_action_enabled(),
|
||||
* g_action_group_get_action_parameter_type(),
|
||||
* g_action_group_get_action_state_type(),
|
||||
* g_action_group_get_action_state_hint() and
|
||||
* g_action_group_get_action_state() with a single function call.
|
||||
* [method@Gio.ActionGroup.has_action], [method@Gio.ActionGroup.get_action_enabled],
|
||||
* [method@Gio.ActionGroup.get_action_parameter_type],
|
||||
* [method@Gio.ActionGroup.get_action_state_type],
|
||||
* [method@Gio.ActionGroup.get_action_state_hint] and
|
||||
* [method@Gio.ActionGroup.get_action_state] with a single function call.
|
||||
*
|
||||
* This provides two main benefits.
|
||||
*
|
||||
* The first is the improvement in efficiency that comes with not having
|
||||
* to perform repeated lookups of the action in order to discover
|
||||
* different things about it. The second is that implementing
|
||||
* #GActionGroup can now be done by only overriding this one virtual
|
||||
* [type@Gio.ActionGroup] can now be done by only overriding this one virtual
|
||||
* function.
|
||||
*
|
||||
* The interface provides a default implementation of this function that
|
||||
@ -761,12 +762,12 @@ g_action_group_action_state_changed (GActionGroup *action_group,
|
||||
* those functions that call this function. All implementations,
|
||||
* therefore, must override either this function or all of the others.
|
||||
*
|
||||
* If the action exists, %TRUE is returned and any of the requested
|
||||
* fields (as indicated by having a non-%NULL reference passed in) are
|
||||
* filled. If the action doesn't exist, %FALSE is returned and the
|
||||
* If the action exists, `TRUE` is returned and any of the requested
|
||||
* fields (as indicated by having a non-`NULL` reference passed in) are
|
||||
* filled. If the action doesn’t exist, `FALSE` is returned and the
|
||||
* fields may or may not have been modified.
|
||||
*
|
||||
* Returns: %TRUE if the action exists, else %FALSE
|
||||
* Returns: `TRUE` if the action exists, else `FALSE`
|
||||
*
|
||||
* Since: 2.32
|
||||
**/
|
||||
|
Loading…
Reference in New Issue
Block a user