Top | ![]() |
![]() |
![]() |
![]() |
ESourceRegistryWatcher watches for changes in an ESourceRegistry and notifies about newly added and enabled ESource instances, the same as about removed or disabled. The amount of notifications can be filtered with “filter” signal.
The watcher listens only for changes, thus it is not pre-populated after
its creation. That's because the owner usually wants to subscribe to
the “filter”, “appeared”
and “disappeared” signals. The owner should
call e_source_registry_watcher_reclaim()
when it has all the needed
signal handlers connected.
ESourceRegistryWatcher * e_source_registry_watcher_new (ESourceRegistry *registry
,const gchar *extension_name
);
Creates a new ESourceRegistryWatcher instance.
The extension_name
can be used as a complementary filter
to “filter” signal.
registry |
||
extension_name |
optional extension name to filter sources with, or |
[nullable] |
Since: 3.26
ESourceRegistry *
e_source_registry_watcher_get_registry
(ESourceRegistryWatcher *watcher
);
Returns the ESourceRegistry passed to e_source_registry_watcher_new()
.
Since: 3.26
const gchar *
e_source_registry_watcher_get_extension_name
(ESourceRegistryWatcher *watcher
);
Since: 3.26
void
e_source_registry_watcher_reclaim (ESourceRegistryWatcher *watcher
);
Reclaims all available sources satisfying the “filter” signal. It doesn't notify about disappeared sources, it notifies only on those appeared.
Since: 3.26