Package: gio

Function g-action-group-action-state-type

Lambda List

g-action-group-action-state-type (group name)

Arguments

group -- a g-action-group object
name -- a string with the name of the action to query

Return Value

The g-variant-type state type, if the action is stateful.

Details

Queries the type of the state of the named action within the action group.

If the action is stateful then this function returns the g-variant-type state type of the state. All calls to the g-action-group-change-action-state function must give a g-variant parameter of this type and the g-action-group-action-state function will return a g-variant parameter of the same type.

If the action is not stateful then this function will return nil. In that case, the g-action-group-action-state function will return nil and you must not call the g-action-group-change-action-state function.

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 with the same name but a different state type.

Note

This function does not return nil as expected for an action with no g-variant-type state type. Your will get a correct return value using the g-action-map-lookup-action function to get the action from the action group and the g-action-state-type function to get the parameter type.
 

See also

2021-9-8