luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-04-15 20:18:05 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Move the GAction SECTION

Browse Source 
Move it to the struct docs.

Helps: #3037
This commit is contained in:
Matthias Clasen 2023-09-25 20:30:23 -04:00 committed by Philip Withnall
parent 43b5985d03
commit 34bdf32b38
1 changed files with 15 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
gio/gaction.c
View File

@ -28,47 +28,37 @@
G_DEFINE_INTERFACE (GAction, g_action, G_TYPE_OBJECT) G_DEFINE_INTERFACE (GAction, g_action, G_TYPE_OBJECT)
/** /**
* SECTION:gaction * GAction:
* @title: GAction
* @short_description: An action interface
* @include: gio/gio.h
* *
* #GAction represents a single named action. * `GAction` represents a single named action.
* *
* The main interface to an action is that it can be activated with * The main interface to an action is that it can be activated with
* g_action_activate(). This results in the 'activate' signal being * [method@Gio.Action.activate]. This results in the 'activate' signal being
* emitted. An activation has a #GVariant parameter (which may be * emitted. An activation has a `GVariant` parameter (which may be
* %NULL). The correct type for the parameter is determined by a static * `NULL`). The correct type for the parameter is determined by a static
* parameter type (which is given at construction time). * parameter type (which is given at construction time).
* *
* An action may optionally have a state, in which case the state may be * An action may optionally have a state, in which case the state may be
* set with g_action_change_state(). This call takes a #GVariant. The * set with [method@Gio.Action.change_state]. This call takes a #GVariant. The
* correct type for the state is determined by a static state type * correct type for the state is determined by a static state type
* (which is given at construction time). * (which is given at construction time).
* *
* The state may have a hint associated with it, specifying its valid * The state may have a hint associated with it, specifying its valid
* range. * range.
* *
* #GAction is merely the interface to the concept of an action, as * `GAction` is merely the interface to the concept of an action, as
* described above. Various implementations of actions exist, including * described above. Various implementations of actions exist, including
* #GSimpleAction. * [struct@Gio.SimpleAction].
* *
* In all cases, the implementing class is responsible for storing the * In all cases, the implementing class is responsible for storing the
* name of the action, the parameter type, the enabled state, the * name of the action, the parameter type, the enabled state, the optional
* optional state type and the state and emitting the appropriate * state type and the state and emitting the appropriate signals when these
* signals when these change. The implementor is responsible for filtering * change. The implementor is responsible for filtering calls to
* calls to g_action_activate() and g_action_change_state() for type * [method@Gio.Action.activate] and [method@Gio.Action.change_state]
* safety and for the state being enabled. * for type safety and for the state being enabled.
* *
* Probably the only useful thing to do with a #GAction is to put it * Probably the only useful thing to do with a `GAction` is to put it
* inside of a #GSimpleActionGroup. * inside of a [struct@Gio.SimpleActionGroup].
**/
/**
* GAction:
*
* #GAction is an opaque data structure and can only be accessed
* using the following functions.
**/ **/
/** /**