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() も参照して ください。