Gio.ActionEntry

Fields

Name

Type

Access

Description

activate

object

r

the callback to connect to the “activate” signal of the action. Since GLib 2.40, this can be None for stateful actions, in which case the default handler is used. For boolean-stated actions with no parameter, this is a toggle. For other state types (and parameter type equal to the state type) this will be a function that just calls change_state (which you should provide).

change_state

object

r

the callback to connect to the “change-state” signal of the action. All stateful actions should provide a handler here; stateless actions should not.

name

str

r/w

the name of the action

padding

[int]

r

parameter_type

str

r/w

the type of the parameter that must be passed to the activate function for this action, given as a single GLib.Variant type string (or None for no parameter)

state

str

r/w

the initial state for this action, given in GVariant text format. The state is parsed with no extra type information, so type tags must be added to the string if they are necessary. Stateless actions should give None here.

Methods

None

Details

class Gio.ActionEntry

This struct defines a single action. It is for use with Gio.ActionMap.add_action_entries().

The order of the items in the structure are intended to reflect frequency of use. It is permissible to use an incomplete initialiser in order to leave some of the later values as None. All values after name are optional. Additional optional fields may be added in the future.

See Gio.ActionMap.add_action_entries() for an example.