QDBusServiceWatcher Class

Documentation sur les fonctions membres

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

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

Le paramètre parent est transmis à la fonction QObject afin de 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'associe à la connexion ` connection `. De plus, cette fonction commence immédiatement à surveiller les modifications apportées à la variable ` watchMode ` du service ` service`.

Le paramètre parent est transmis à QObject afin de 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 doit être utilisée dans la mesure du possible pour ajouter des services.

Supprime toute liaison existante avec watchedServices.

QDBusConnection QDBusServiceWatcher::connection() const

Renvoie l'QDBusConnection e auquel cet objet est associé.

Voir aussi setConnection().

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

Supprime l'service de la liste des services surveillés par cet objet. Notez que les notifications D-Bus sont asynchrones ; il se peut donc qu'il reste des signaux en attente d'envoi concernant service. Ces signaux seront tout de même émis dès que 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 le nom de l’ancien propriétaire et « newOwner » celui du nouveau propriétaire. « oldOwner » et « newOwner » sont tous deux des noms de connexion uniques.

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

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

Voir également serviceRegistered() et serviceUnregistered().

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

Ce signal est émis dès que cet objet détecte que le service serviceName est disponible sur le bus.

Voir également serviceUnregistered() et serviceOwnerChanged().

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

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

Voir également serviceRegistered() et serviceOwnerChanged().

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

Définit la connexion D-Bus à laquelle cet objet est associé sur 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 à cette connexion tant qu’elle existera. La connexion n’est pas fermée tant que le compteur de références n’est pas tombé à zéro, ce qui garantit que toutes les notifications seront reçues tant que cet objet ` QDBusServiceWatcher ` existera.

Voir également connection().

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

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

Notez que définir la liste dans son intégralité revient à supprimer toutes les règles de surveillance des services existantes et à en ajouter de nouvelles. Il s'agit d'une opération coûteuse en ressources qui doit être évitée dans la mesure du possible. Utilisez plutôt addWatchedService() et removeWatchedService() si vous le pouvez pour modifier 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 surveillés.

Voir aussi setWatchedServices().