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 は、この接続が存在する間、この接続の参照を保持します。参照カウントがゼロになるまで接続はクローズされないので、このQDBusServiceWatcher オブジェクトが存在する間、すべての通知を確実に受け取ることができます。

connection()も参照のこと 。

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

監視するD-Busサービスのリストをservices に設定する。

リスト全体を設定することは、サービスを監視するための以前のルールをすべて削除し、新しいルールを追加することを意味することに注意。これは高価な操作であるため、可能であれば避けるべきである。代わりに、リスト内のエントリを操作するために、可能であればaddWatchedService() とremoveWatchedService() を使用する。

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

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

QStringList QDBusServiceWatcher::watchedServices() const

監視対象の D-Bus サービスのリストを返す。

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