QDBusServiceWatcher 类

成员函数文档

[显式] 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 以设置此对象的父对象。

[虚拟 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通知是异步的，因此仍然可能会signal待发布关于service的信息。这些信号将在处理D-Bus消息时仍然被发出。

删除任何现有的watchedServices绑定。

如果删除了任何服务，此函数返回true。

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

每当此对象检测到涉及serviceName服务的所有者变更时，都会发出此信号。参数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。