AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

actionobserver: Clarify primary_accel_changed docs

Browse Source 
Either action_name or action_and_target may be NULL
here, and observer implementations should be careful
when checking those values.
This commit is contained in:
Matthias Clasen 2021-06-16 10:34:37 -04:00
parent 7b1a7629bc
commit 424dd8a463
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
gtk/gtkactionobserver.c
View File

@ -158,15 +158,17 @@ gtk_action_observer_action_removed (GtkActionObserver *observer,
* gtk_action_observer_primary_accel_changed:
* @observer: a `GtkActionObserver`
* @observable: the source of the event
* @action_name: the name of the action
* @action_and_target: detailed action of the changed accel, in “action and target” format
* @action_name: (nullable): the name of the action
* @action_and_target: (nullable): detailed action of the changed accel, in “action and target” format
*
* This function is called when an action that the observer is
* registered to receive events for has one of its accelerators changed.
*
* Accelerator changes are reported for all targets associated with the
* action. The @action_and_target string should be used to check if the
* action. The @action_and_target string should be used to check if the
* reported target is the one that the observer is interested in.
*
* Either @action_name or @action_and_target may be %NULL.
*/
void
gtk_action_observer_primary_accel_changed (GtkActionObserver *observer,