g-object, common-lisp:standard-object, common-lisp:t

g-property-action, g-simple-action

The g-action interface represents a single named action.

The main interface to an action is that it can be activated with the g-action-activate function. This results in the "activate" signal being emitted. An activation has a g-variant parameter, which may be nil. The correct type for the parameter is determined by a static parameter type, which is given at construction time.

An action may optionally have a state, in which case the state may be set with the g-action-change-state function. This call takes a g-variant parameter. The correct type for the state is determined by a static state type, which is given at construction time.

The state may have a hint associated with it, specifying its valid range.

The g-action interface is merely the interface to the concept of an action, as described above. Various implementations of actions exist, including the g-simple-action class.

In all cases, the implementing class is responsible for storing the name of the action, the parameter type, the enabled state, the optional state type and the state and emitting the appropriate signals when these change. The implementor responsible for filtering calls to the g-action-activate and g-action-change-state functions for type safety and for the state being enabled.

Probably the only useful thing to do with a g-action object is to put it inside of a g-simple-action-group object.