Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QDBusConnectionInterface Class Reference
^{[QtDBus module]}

该QDBusConnectionInterface类提供​​访问D - Bus总线守护进程服务。More...

继承QDBusAbstractInterface。

Types

• enum RegisterServiceReply { ServiceNotRegistered, ServiceRegistered, ServiceQueued }
• enum ServiceQueueOptions { DontQueueService, QueueService, ReplaceExistingService }
• enum ServiceReplacementOptions { DontAllowReplacement, AllowReplacement }

Methods

• connectNotify (self, SIGNAL())
• disconnectNotify (self, SIGNAL())
• QDBusReply isServiceRegistered (self, QString serviceName)
• QDBusReply registeredServiceNames (self)
• QDBusReply registerService (self, QString serviceName, ServiceQueueOptions qoption = QDBusConnectionInterface.DontQueueService, ServiceReplacementOptions roption = QDBusConnectionInterface.DontAllowReplacement)
• QDBusReply serviceOwner (self, QString name)
• QDBusReply servicePid (self, QString serviceName)
• QDBusReply serviceUid (self, QString serviceName)
• QDBusReply startService (self, QString name)
• QDBusReply unregisterService (self, QString serviceName)

Qt Signals

• void callWithCallbackFailed (const QDBusError&,const QDBusMessage&)
• void serviceOwnerChanged (const QString&,const QString&,const QString&)
• void serviceRegistered (const QString&)
• void serviceUnregistered (const QString&)

Detailed Description

该QDBusConnectionInterface类提供​​访问D - Bus总线守护进程服务。

在D - Bus总线服务器守护进程提供1个专用接口org.freedesktop.DBus允许客户端访问总线的某些属性，如连接的客户端的列表。该QDBusConnectionInterface类提供了访问该界面。

这个类最常见的用途是用在总线上注册和注销服务名称registerService（）和unregisterService采用（ ）函数，查询有关现有名称isServiceRegistered（ ）registeredServiceNames（）和serviceOwner（ ）函数，并接收客户端已通过注册或取消注册的通知serviceRegistered（ ）serviceUnregistered（）和serviceOwnerChanged（ ）信号。

Type Documentation

QDBusConnectionInterface.RegisterServiceReply

从可能的返回值registerService（）：

该serviceRegistered当由该应用程序获得的服务（）信号将被发射。

QDBusConnectionInterface.ServiceQueueOptions

标志确定一个服务注册应该如何表现，如果服务名已被注册。

See also ServiceReplacementOptions。

QDBusConnectionInterface.ServiceReplacementOptions

标志确定，如果D- Bus服务器应该允许其他应用程序来替换一个名字，这个应用程序已经注册了ReplaceExistingService选项。

可能的值有：

See also ServiceQueueOptions。

Method Documentation

QDBusConnectionInterface.connectNotify (self, SIGNAL())

QDBusConnectionInterface.disconnectNotify (self, SIGNAL())

QDBusReply QDBusConnectionInterface.isServiceRegistered (self, QString serviceName)

返回True如果服务名称serviceName拥有目前登记。

QDBusReply QDBusConnectionInterface.registeredServiceNames (self)

QDBusReply QDBusConnectionInterface.registerService (self, QString serviceName, ServiceQueueOptions qoption = QDBusConnectionInterface.DontQueueService, ServiceReplacementOptions roption = QDBusConnectionInterface.DontAllowReplacement)

申请注册的服务名serviceName在总线上。该qoption标志指定的D-Bus的服务器应该怎么做，如果serviceName已经注册。该roption标志指定服务器应该允许其他应用程序来取代我们的注册名称。

如果服务注册成功，serviceRegistered（）信号将被发射。如果被放置在队列中，该信号将在我们获得的名称被发射。如果roption is AllowReplacement时，serviceUnregistered（ ）信号会在另一个应用程序取代了这一个发射。

See also unregisterService（ ） 。

QDBusReply QDBusConnectionInterface.serviceOwner (self, QString name)

返回名称的主要所有者的唯一连接名称name。如果请求的名字没有一个老板，返回org.freedesktop.DBus.Error.NameHasNoOwner错误。

QDBusReply QDBusConnectionInterface.servicePid (self, QString serviceName)

返回的Unix进程ID（PID ）为目前持有的巴士服务的过程serviceName。

QDBusReply QDBusConnectionInterface.serviceUid (self, QString serviceName)

返回的Unix用户ID（ UID）为目前持有的巴士服务的过程serviceName。

QDBusReply QDBusConnectionInterface.startService (self, QString name)

要求该总线开始由给定名称的服务name。

QDBusReply QDBusConnectionInterface.unregisterService (self, QString serviceName)

发布于巴士服务名索赔serviceName，这已与以前登记registerService（ ） 。如果这个应用程序有名称的所有权，它会被释放用于其他应用要求。如果只有名字排队，它放弃其在队列中的位置。

Qt Signal Documentation

void callWithCallbackFailed (const QDBusError&,const QDBusMessage&)

这是该信号的默认超载。

当存在时是一个错误，这个信号被发射的QDBusConnection.callWithCallback（ ） 。error指定错误。call是无法传递的消息。

See also QDBusConnection.callWithCallback（ ） 。

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

这是该信号的默认超载。

这个信号是由D - Bus服务器发出每当服务所有权的变化发生在公交车，其中包括幻影的名字和disparition 。

这个信号表示该应用程序oldOwner的总线名称丧失所有权name应用newOwner。如果oldOwner是一个空字符串，它表示的名称name刚刚被创建，如果newOwner是空的，名称name目前尚无所有者和不再可用。

Note:连接到该信号将使应用程序监听并接收总线上的每一个服务的所有权变更。取决于有多少服务正在运行，这使应用程序被激活，以获得更多的信号比它需要。要避免此问题，请使用QDBusServiceWatcher类，它可以侦听特定的变化。

void serviceRegistered (const QString&)

这是该信号的默认超载。

这个信号是由D-Bus的服务器当巴士服务名称（唯一的连接名称或知名服务名称）由下式给出发射serviceName由该应用程序获得的。

收购之后会发生这个应用程序使用请求的名称registerService（ ） 。

void serviceUnregistered (const QString&)

这是该信号的默认超载。

这个信号是由D - Bus服务器时发出此应用程序失去由下式给出的巴士服务名称的所有权serviceName。