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

gsignal: add a clarification to the docs

Browse Source 
As evidenced by a mistake that I made recently, this documentation could
use a little bit of clarification.
This commit is contained in:
Ryan Lortie 2014-11-28 16:20:40 -05:00
parent d511d6b37f
commit c476f7cd26
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
gobject/gsignal.c
View File

@ -2867,6 +2867,12 @@ g_signal_handlers_disconnect_matched (gpointer instance,
* Returns whether there are any handlers connected to @instance for the * Returns whether there are any handlers connected to @instance for the
* given signal id and detail. * given signal id and detail.
* *
* If @detail is 0 then it will only match handlers that were connected
* without detail. If @detail is non-zero then it will match handlers
* connected both without detail and with the given detail. This is
* consistent with how a signal emitted with @detail would be delivered
* to those handlers.
*
* One example of when you might use this is when the arguments to the * One example of when you might use this is when the arguments to the
* signal are difficult to compute. A class implementor may opt to not * signal are difficult to compute. A class implementor may opt to not
* emit the signal if no one is attached anyway, thus saving the cost * emit the signal if no one is attached anyway, thus saving the cost