The "change-event" signal is emitted once per change event that affects this settings object.
You should connect to this signal only if you are interested in viewing groups of changes before they are split out into multiple emissions of the "changed" signal. For most use cases it is more appropriate to use the "changed" signal.
In the event that the change event applies to one or more specified keys, keys
will be an array of
Quark of length keys.length
. In the event that the change event applies to the
Settings object as a whole (ie: potentially every key has been changed) then keys
will be null and keys.length
will be 0.
The default handler for this signal invokes the "changed" signal for each affected key. If any other connected handler returns true then this default functionality will be suppressed.
keys |
an array of Quarks for the changed keys, or null |
n_keys |
the length of the |
true to stop other handlers from being invoked for the event. FALSE to propagate the event further. |