path_changed


Description:

[ CCode ( feature_test_macro = "G_SETTINGS_ENABLE_BACKEND" ) ]
[ Version ( since = "2.26" ) ]
public void path_changed (string path, void* origin_tag)

Signals that all keys below a given path may have possibly changed.

Backend implementations should call this if an entire path of keys have possibly changed their values.

path must be a valid path (ie starting and ending with a slash and not containing '//').

The meaning of this signal is that any of the key which has a name starting with path may have changed.

The same rules for when notifications must occur apply as per changed. This call might be an appropriate reasponse to a 'reset' call but implementations are also free to explicitly list the keys that were affected by that call if they can easily do so.

For efficiency reasons, the implementation should strive for path to be as long as possible (ie: the longest common prefix of all of the keys that were changed) but this is not strictly required. As an example, if this function is called with the path of "/" then every single key in the application will be notified of a possible change.

Parameters:

this

a SettingsBackend implementation

path

the path containing the changes

origin_tag

the origin tag