QDBusServiceWatcher Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein QDBusServiceWatcher-Objekt. Beachten Sie, dass dieses Objekt keine Signale aussendet, solange Sie keine Verbindung mit ` setConnection()` hergestellt haben.

Der Parameter ` parent ` wird an ` QObject ` übergeben, um den übergeordneten Knoten dieses Objekts festzulegen.

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

Erstellt ein QDBusServiceWatcher-Objekt und fügt es der Verbindung „ connection “ hinzu. Außerdem beginnt diese Funktion sofort damit, auf Änderungen an „ watchMode “ für den Dienst „ service “ zu achten.

Der Parameter „ parent “ wird an „ QObject “ übergeben, um den übergeordneten Knoten dieses Objekts festzulegen.

[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()

Löscht das „ QDBusServiceWatcher “-Objekt und gibt alle damit verbundenen Ressourcen frei.

void QDBusServiceWatcher::addWatchedService(const QString &newService)

Fügt newService zur Liste der Dienste hinzu, die von diesem Objekt überwacht werden sollen. Diese Funktion ist effizienter als setWatchedServices() und sollte nach Möglichkeit zum Hinzufügen von Diensten verwendet werden.

Entfernt alle vorhandenen Bindungen von watchedServices.

QDBusConnection QDBusServiceWatcher::connection() const

Gibt den „ QDBusConnection “ zurück, an den dieses Objekt angehängt ist.

Siehe auch ` setConnection()`.

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

Entfernt „ service “ aus der Liste der Dienste, die von diesem Objekt überwacht werden. Beachten Sie, dass D-Bus-Benachrichtigungen asynchron erfolgen, sodass möglicherweise noch Signale bezüglich „ service “ zur Zustellung anstehen. Diese Signale werden weiterhin ausgesendet, sobald die D-Bus-Nachrichten verarbeitet werden.

Entfernt alle vorhandenen Bindungen zu „ watchedServices “.

Diese Funktion gibt „ true “ zurück, falls Dienste entfernt wurden.

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

Dieses Signal wird immer dann ausgelöst, wenn dieses Objekt feststellt, dass eine Änderung des Dienstinhabers in Bezug auf den Dienst „ serviceName “ stattgefunden hat. Der Parameter „ oldOwner “ enthält den Namen des bisherigen Inhabers, und „ newOwner “ ist der Name des neuen Inhabers. Sowohl „ oldOwner “ als auch „ newOwner “ sind eindeutige Verbindungsnamen.

Beachten Sie, dass dieses Signal auch immer dann ausgegeben wird, wenn der Dienst „ serviceName “ registriert oder deregistriert wurde. Bei einer Registrierung enthält „ oldOwner “ eine leere Zeichenkette, bei einer Deregistrierung hingegen enthält „ newOwner “ eine leere Zeichenkette.

Wenn Sie lediglich feststellen möchten, ob der Dienst registriert oder abgemeldet ist, ohne über eine Änderung der Eigentumsverhältnisse benachrichtigt zu werden, sollten Sie die spezifischen Modi für diese Vorgänge in Betracht ziehen. Diese Klasse ist effizienter, wenn Sie die spezifischeren Modi verwenden.

Siehe auch serviceRegistered() und serviceUnregistered().

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

Dieses Signal wird ausgegeben, sobald dieses Objekt feststellt, dass der Dienst „ serviceName “ auf dem Bus verfügbar ist.

Siehe auch serviceUnregistered() und serviceOwnerChanged().

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

Dieses Signal wird ausgegeben, sobald dieses Objekt feststellt, dass der Dienst serviceName vom Bus abgemeldet wurde und nicht mehr verfügbar ist.

Siehe auch „ serviceRegistered()“ und „ serviceOwnerChanged()“.

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

Legt die D-Bus-Verbindung, an die dieses Objekt angehängt ist, auf „ connection “ fest. Alle überwachten Dienste werden auf diese Verbindung übertragen.

Beachten Sie, dass Objekte vom Typ „ QDBusConnection “ referenzgezählt werden: „ QDBusServiceWatcher “ behält eine Referenz auf diese Verbindung, solange diese existiert. Die Verbindung wird erst geschlossen, wenn die Referenzanzahl auf Null sinkt. Dadurch wird sichergestellt, dass alle Benachrichtigungen empfangen werden, solange dieses „ QDBusServiceWatcher “-Objekt existiert.

Siehe auch connection().

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

Legt die Liste der überwachten D-Bus-Dienste auf „ services “ fest.

Beachten Sie, dass das Festlegen der gesamten Liste bedeutet, dass alle bisherigen Regeln zur Überwachung von Diensten entfernt und neue hinzugefügt werden. Dies ist ein ressourcenintensiver Vorgang und sollte nach Möglichkeit vermieden werden. Verwenden Sie stattdessen nach Möglichkeit addWatchedService() und removeWatchedService(), um Einträge in der Liste zu bearbeiten.

Entfernt alle vorhandenen Zuordnungen von „ watchedServices “.

Siehe auch watchedServices().

QStringList QDBusServiceWatcher::watchedServices() const

Gibt die Liste der D-Bus-Dienste zurück, die überwacht werden.

Siehe auch „ setWatchedServices()“.