:right-sidebar: True

ActionEntry
===================================================================

.. currentmodule:: gi.repository.Gio





.. class:: ActionEntry(*args, **kwargs)
   :no-contents-entry:






This struct defines a single action.  It is for use with
:obj:`~gi.repository.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 ``NULL``\.  All values
after ``name`` are optional.  Additional optional fields may be added in
the future.

See :obj:`~gi.repository.Gio.ActionMap.add_action_entries` for an example.












Fields
------

.. rst-class:: interim-class

.. class:: ActionEntry
   :no-index:
   

   .. attribute:: activate

      The callback to connect to the "activate" signal of the action.
        Since GLib 2.40, this can be ``NULL`` 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).






   .. attribute:: change_state

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






   .. attribute:: name

      The name of the action






   .. attribute:: padding

      






   .. attribute:: parameter_type

      The type of the parameter that must be passed to the
        activate function for this action, given as a single GVariant type string
        (or ``NULL`` for no parameter)






   .. attribute:: state

      The initial state for this action, given in
        `GVariant text format <gvariant-text-format.html>`__\.  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 ``NULL`` here.