QDBusServiceWatcher Class Reference

[QtDBus module]

该QDBusServiceWatcher类允许用户观看的巴士服务的变化。More…

继承QObject。

Types

• class **[WatchMode](docs_index.htm)**
• enum WatchModeFlag { WatchForRegistration, WatchForUnregistration, WatchForOwnerChange }

Methods

• __init__ (self, QObject parent = None)
• __init__ (self, QString service, QDBusConnection connection, WatchMode watchMode = QDBusServiceWatcher.WatchForOwnerChange, QObject parent = None)
• addWatchedService (self, QString newService)
• QDBusConnection connection (self)
• bool removeWatchedService (self, QString service)
• setConnection (self, QDBusConnection connection)
• setWatchedServices (self, QStringList services)
• setWatchMode (self, WatchMode mode)
• QStringList watchedServices (self)
• WatchMode watchMode (self)

Qt Signals

• void serviceOwnerChanged (const QString&,const QString&,const QString&)
• void serviceRegistered (const QString&)
• void serviceUnregistered (const QString&)

Detailed Description

该QDBusServiceWatcher类允许用户观看的巴士服务的变化。

一个QDBusServiceWatcher对象可以用来通知用户有关服务名的总线上的所有权变更申请。它有三个手表模式：

• Watching for service registration only.
• Watching for service unregistration only.
• Watching for any kind of service ownership change (the default mode).

除了被创建或删除，服务可能会改变所有人没有注销/寄存器操作发生的事情。所以，serviceRegistered（）和serviceUnregistered如果发生这种情况（）信号可能不被发射。

这个类是比使用更高效的QDBusConnectionInterface.serviceOwnerChanged（ ）信号，因为它允许一个只接收为其类是感兴趣的信号

Type Documentation

QDBusServiceWatcher.WatchModeFlag

QDBusServiceWatcher支持三种不同的观看模式，这是由该标志配置：

该WatchMode类型是一个typedef为QFlags\u003cWatchModeFlag\u003e 。它存储WatchModeFlag值的或组合。

Method Documentation

QDBusServiceWatcher.__init__ (self, QObject parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

创建QDBusServiceWatcher对象。需要注意的是，直到你设置一个连接setConnection（ ） ，这个对象将不会发出任何信号。

该parent参数被传递到QObject设置该对象的父。

QDBusServiceWatcher.__init__ (self, QString service, QDBusConnection connection, WatchMode watchMode = QDBusServiceWatcher.WatchForOwnerChange, QObject parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

创建QDBusServiceWatcher对象，并将其附加到connection连接。另外，此功能将立即启动窥伺watchMode更改服务service。

该parent参数被传递到QObject设置该对象的父。

QDBusServiceWatcher.addWatchedService (self, QString newService)

添加newService到服务，通过该对象被监视的列表。这个函数是比更有效setWatchedServices（ ），并应尽可能使用添加服务。

QDBusConnection QDBusServiceWatcher.connection (self)

返回QDBusConnection这个对象附加到。

See also setConnection（ ） 。

bool QDBusServiceWatcher.removeWatchedService (self, QString service)

移除service从正在观看由该对象的服务的列表。需要注意的是D-Bus的通知是异步的，所以有可能还是待交付有关信号service。每当D-Bus的消息处理这些信号仍然会排放。

如果被拆除的任何服务该函数返回True。

QDBusServiceWatcher.setConnection (self, QDBusConnection connection)

设置D-Bus的连接，这个对象附加到会connection。看着所有服务将被转移到这方面。

需要注意的是QDBusConnection对象引用计数：QDBusServiceWatcher将保持一个参考此连接，而它的存在。连接不关闭，直到引用计数下降到零，所以这将确保任何通知而收到这QDBusServiceWatcher对象存在。

See also connection（ ） 。

QDBusServiceWatcher.setWatchedServices (self, QStringList services)

QDBusServiceWatcher.setWatchMode (self, WatchMode mode)

QStringList QDBusServiceWatcher.watchedServices (self)

WatchMode QDBusServiceWatcher.watchMode (self)

[

Qt Signal Documentation

void serviceOwnerChanged (const QString&,const QString&,const QString&)

这是该信号的默认超载。

每当这个对象检测到有关于该服务的所有权改变这个信号被发射serviceName服务。该oldOwner参数包含旧的所有者名称和newOwner是新的主人。两oldOwner和newOwner是唯一的连接名。

注意，此信号也被发射时的serviceName服务注册或未注册。如果它被注册，oldOwner将包含一个空字符串，而如果是未注册的，newOwner将包含一个空字符串。

如果你只需要找出如果该服务被注册或只登记，不被通知的所有权变更，请考虑使用这些操作的具体模式。如果您使用更具体的模式这个类是更有效的。

](docs_index.htm)

See also serviceRegistered（）和serviceUnregistered（ ） 。

void serviceRegistered (const QString&)

这是该信号的默认超载。

每当这个对象检测这个信号被发射，该服务serviceName在公共汽车上变得可用。

See also serviceUnregistered（）和serviceOwnerChanged（ ） 。

void serviceUnregistered (const QString&)

这是该信号的默认超载。

每当这个对象检测这个信号被发射，该服务serviceName从总线被取消注册，并不再可用。

See also serviceRegistered（）和serviceOwnerChanged（ ） 。