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

GActionGroup: Mention GMenuModel in the docs

Browse Source
This commit is contained in:
Matthias Clasen
2011-11-26 21:44:46 -05:00
committed by Ryan Lortie
parent ae0bd032ca
commit 435b2418da
1 changed files with 5 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
gio/gactiongroup.c
View File

@@ -35,12 +35,15 @@
* method calls, except g_action_group_list_actions() take the name of * method calls, except g_action_group_list_actions() take the name of
* an action as an argument. * an action as an argument.
* *
* Action groups are often used together with a #GMenuModel that provides
* additional representation data for the actions.
*
* The #GActionGroup API is meant to be the 'public' API to the action * The #GActionGroup API is meant to be the 'public' API to the action
* group. The calls here are exactly the interaction that 'external * group. The calls here are exactly the interaction that 'external
* forces' (eg: UI, incoming D-Bus messages, etc.) are supposed to have * forces' (eg: UI, incoming D-Bus messages, etc.) are supposed to have
* with actions. 'Internal' APIs (ie: ones meant only to be accessed by * with actions. 'Internal' APIs (ie: ones meant only to be accessed by
* the action group implementation) are found on subclasses. This is * the action group implementation) are found on subclasses. This is
* why you will find -- for example -- g_action_group_get_action_enabled() * why you will find - for example - g_action_group_get_action_enabled()
* but not an equivalent <function>set()</function> call. * but not an equivalent <function>set()</function> call.
* *
* Signals are emitted on the action group in response to state changes * Signals are emitted on the action group in response to state changes
@@ -49,7 +52,7 @@
* Implementations of #GActionGroup should provide implementations for * Implementations of #GActionGroup should provide implementations for
* the virtual functions g_action_group_list_actions() and * the virtual functions g_action_group_list_actions() and
* g_action_group_query_action(). The other virtual functions should * g_action_group_query_action(). The other virtual functions should
* not be implemented -- their "wrappers" are actually implemented with * not be implemented - their "wrappers" are actually implemented with
* calls to g_action_group_query_action(). * calls to g_action_group_query_action().
**/ **/