luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-26 15:36:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

GActionEntry: improve documentation

Browse Source 
Document that giving %NULL for the activate handler is supported since
GLib 2.40.  We documented this on GSimpleAction itself (where the
default handler functionality is implemented) but expecting the user to
dig that up is asking a bit much.

Also, add some more explicit documentation about the conditions under
which each field is expected to be filled in.

https://bugzilla.gnome.org/show_bug.cgi?id=732429
This commit is contained in:
Ryan Lortie 2014-06-29 11:13:25 -04:00
parent 1b3deb5f56
commit c78037773b
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
gio/gactionmap.c
View File

@ -124,16 +124,22 @@ g_action_map_remove_action (GActionMap *action_map,
* GActionEntry: * GActionEntry:
* @name: the name of the action * @name: the name of the action
* @activate: the callback to connect to the "activate" signal of the * @activate: the callback to connect to the "activate" signal of the
* action * 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).
* @parameter_type: the type of the parameter that must be passed to the * @parameter_type: the type of the parameter that must be passed to the
* activate function for this action, given as a single * activate function for this action, given as a single
* GVariant type string (or %NULL for no parameter) * GVariant type string (or %NULL for no parameter)
* @state: the initial state for this action, given in GVariant text * @state: the initial state for this action, given in GVariant text
* format. The state is parsed with no extra type information, * format. The state is parsed with no extra type information,
* so type tags must be added to the string if they are * so type tags must be added to the string if they are
* necessary. * necessary. Stateless actions should give %NULL here.
* @change_state: the callback to connect to the "change-state" signal * @change_state: the callback to connect to the "change-state" signal
* of the action * of the action. All stateful actions should provide a
* handler here; stateless actions should not.
* *
* This struct defines a single action. It is for use with * This struct defines a single action. It is for use with
* g_action_map_add_action_entries(). * g_action_map_add_action_entries().