change_event


Description:

public virtual signal bool change_event (Quark[]? keys)

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.

Parameters:

keys

an array of Quarks for the changed keys, or null

n_keys

the length of the keys array, or 0

Returns:

true to stop other handlers from being invoked for the event. FALSE to propagate the event further.




2022 vala-language.org