QDBusServiceWatcher Class

Documentation des fonctions membres

[explicit] QDBusServiceWatcher::QDBusServiceWatcher(QObject *parent = nullptr)

Crée un objet QDBusServiceWatcher. Notez que tant que vous n'avez pas établi de connexion avec setConnection(), cet objet n'émettra aucun signal.

Le paramètre parent est transmis à QObject pour définir le parent de cet objet.

QDBusServiceWatcher::QDBusServiceWatcher(const QString &service, const QDBusConnection &connection, QDBusServiceWatcher::WatchMode watchMode = WatchForOwnerChange, QObject *parent = nullptr)

Crée un objet QDBusServiceWatcher et l'attache à la connexion connection. De plus, cette fonction commence immédiatement à surveiller les modifications apportées par watchMode au service service.

Le paramètre parent est transmis à QObject pour définir le parent de cet objet.

[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()

Détruit l'objet QDBusServiceWatcher et libère toutes les ressources qui lui sont associées.

void QDBusServiceWatcher::addWatchedService(const QString &newService)

Ajoute newService à la liste des services à surveiller par cet objet. Cette fonction est plus efficace que setWatchedServices() et devrait être utilisée chaque fois que possible pour ajouter des services.

Supprime toute liaison existante de watchedServices.

QDBusConnection QDBusServiceWatcher::connection() const

Renvoie l'adresse QDBusConnection à laquelle cet objet est attaché.

Voir aussi setConnection().

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

Supprime le site service de la liste des services surveillés par cet objet. Notez que les notifications D-Bus sont asynchrones et qu'il peut donc y avoir des signaux en attente de livraison à propos de service. Ces signaux seront toujours émis lorsque les messages D-Bus seront traités.

Supprime toute liaison existante avec watchedServices.

Cette fonction renvoie true si des services ont été supprimés.

[signal] void QDBusServiceWatcher::serviceOwnerChanged(const QString &serviceName, const QString &oldOwner, const QString &newOwner)

Ce signal est émis chaque fois que cet objet détecte un changement de propriétaire du service serviceName. Le paramètre oldOwner contient l'ancien nom du propriétaire et newOwner est le nouveau propriétaire. oldOwner et newOwner sont des noms de connexion uniques.

Notez que ce signal est également émis lorsque le service serviceName a été enregistré ou désenregistré. S'il a été enregistré, oldOwner contiendra une chaîne vide, tandis que s'il n'a pas été enregistré, newOwner contiendra une chaîne vide.

Si vous souhaitez uniquement savoir si le service est enregistré ou non enregistré, sans être informé du changement de propriétaire, envisagez d'utiliser les modes spécifiques pour ces opérations. Cette classe est plus efficace si vous utilisez les modes plus spécifiques.

Voir aussi serviceRegistered() et serviceUnregistered().

[signal] void QDBusServiceWatcher::serviceRegistered(const QString &serviceName)

Ce signal est émis chaque fois que cet objet détecte que le service serviceName est devenu disponible sur le bus.

Voir également serviceUnregistered() et serviceOwnerChanged().

[signal] void QDBusServiceWatcher::serviceUnregistered(const QString &serviceName)

Ce signal est émis chaque fois que cet objet détecte que le service serviceName a été désenregistré du bus et n'est plus disponible.

Voir aussi serviceRegistered() et serviceOwnerChanged().

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

Définit la connexion D-Bus à laquelle cet objet est attaché comme étant connection. Tous les services surveillés seront transférés vers cette connexion.

Notez que les objets QDBusConnection sont comptés par référence : QDBusServiceWatcher conservera une référence pour cette connexion tant qu'elle existera. La connexion n'est pas fermée tant que le nombre de références n'est pas tombé à zéro, ce qui garantit que toutes les notifications sont reçues tant que l'objet QDBusServiceWatcher existe.

Voir aussi connection().

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

Définit la liste des services D-Bus surveillés à services.

Notez que la définition de la liste entière implique la suppression de toutes les règles précédentes de surveillance des services et l'ajout de nouvelles règles. Cette opération est coûteuse et doit être évitée dans la mesure du possible. Utilisez plutôt addWatchedService() et removeWatchedService() si vous le pouvez pour manipuler les entrées de la liste.

Supprime toute liaison existante de watchedServices.

Voir également watchedServices().

QStringList QDBusServiceWatcher::watchedServices() const

Renvoie la liste des services D-Bus qui sont surveillés.

Voir aussi setWatchedServices().