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()。