QDBusServiceWatcher Class

メンバ関数のドキュメント

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

QDBusServiceWatcher オブジェクトを作成します。setConnection() を使用して接続を設定するまでは、このオブジェクトはシグナルを発信しないことに注意してください。

parent パラメータは、QObject に渡され、このオブジェクトの親を設定するために使用されます。

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

QDBusServiceWatcher オブジェクトを作成し、それをconnection 接続に接続します。また、この関数は、サービスservice に対するwatchMode の変更を直ちに監視し始めます。

parent パラメータは、このオブジェクトの親を設定するためにQObject に渡されます。

[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()

QDBusServiceWatcher オブジェクトを破棄し、それに関連付けられているリソースをすべて解放します。

void QDBusServiceWatcher::addWatchedService(const QString &newService)

このオブジェクトが監視するサービスのリストに、newService を追加します。この関数はsetWatchedServices() よりも効率的であるため、サービスを追加する際は可能な限りこの関数を使用してください。

watchedServices に対する既存のバインディングをすべて削除します。

QDBusConnection QDBusServiceWatcher::connection() const

このオブジェクトがアタッチされているQDBusConnection を返します。

「setConnection()」も参照してください 。

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

このオブジェクトが監視しているサービスのリストから、service を削除します。D-Bus 通知は非同期であるため、service に関する配信待ちのシグナルがまだ残っている可能性があることに注意してください。これらのシグナルは、D-Bus メッセージが処理されるたびに引き続き発火します。

watchedServices に対する既存のバインディングをすべて削除します。

この関数は、サービスが削除された場合、true を返します。

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

このオブジェクトが、serviceName サービスに関連するサービスの所有権の変更を検出した際に、このシグナルが発信されます。oldOwner パラメータには旧所有者の名前が、newOwner には新所有者の名前が含まれます。oldOwner とnewOwner は、いずれも一意の接続名です。

なお、このシグナルは、serviceName サービスが登録または登録解除された際にも発火します。登録された場合はoldOwner に空文字列が格納され、登録解除された場合はnewOwner に空文字列が格納されます。

所有権の変更通知を受け取る必要がなく、単にサービスが登録されているか解除されているかを確認したいだけの場合は、それらの操作専用のモードの使用を検討してください。より具体的なモードを使用すると、このクラスの処理効率が向上します。

serviceRegistered() およびserviceUnregistered()も参照してください 。

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

このオブジェクトが、バス上でサービスserviceName が利用可能になったことを検出した際に、このシグナルが発信されます。

serviceUnregistered() およびserviceOwnerChanged()も参照してください 。

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

このオブジェクトが、サービスserviceName がバスから登録解除され、利用できなくなったことを検出した際に、このシグナルが発信されます。

serviceRegistered() およびserviceOwnerChanged()も参照してください 。

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

このオブジェクトが接続されている D-Bus 接続を `connection` に設定します。監視対象のすべてのサービスが、この接続に移行されます。

なお、QDBusConnection オブジェクトは参照カウント制を採用しています。つまり、QDBusServiceWatcher はこの接続が存在する限り、その参照を保持し続けます。参照カウントが 0 になるまで接続は閉じられないため、このQDBusServiceWatcher オブジェクトが存在している間は、すべての通知が確実に受信されるようになります。

connection()も参照してください 。

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

監視対象の D-Bus サービスのリストを `services` に設定します。

リスト全体を設定すると、サービス監視に関する既存のルールがすべて削除され、新しいルールが追加される点に注意してください。これは負荷の高い操作であるため、可能であれば避けるべきです。代わりに、リスト内のエントリを操作する際は、可能であれば `addWatchedService()` および `removeWatchedService()` を使用してください。

watchedServices に対する既存のバインディングをすべて削除します。

watchedServices()も参照してください 。

QStringList QDBusServiceWatcher::watchedServices() const

監視対象となっている D-Bus サービスのリストを返します。

関連項目： setWatchedServices()。