QDBusMessage Class Reference

[QtDBus module]

该QDBusMessage类表示发送或接收通过D - Bus总线一个消息。More…

Types

• enum MessageType { InvalidMessage, MethodCallMessage, ReplyMessage, ErrorMessage, SignalMessage }

Methods

• __init__ (self)
• __init__ (self, QDBusMessage other)
• list-of-QVariant arguments (self)
• bool autoStartService (self)
• QDBusMessage createErrorReply (self, QString name, QString msg)
• QDBusMessage createErrorReply (self, QDBusError error)
• QDBusMessage createErrorReply (self, QDBusError.ErrorType type, QString msg)
• QDBusMessage createReply (self, list-of-QVariant arguments = QList<QVariant>())
• QDBusMessage createReply (self, QVariant argument)
• QString errorMessage (self)
• QString errorName (self)
• QString interface (self)
• bool isDelayedReply (self)
• bool isReplyRequired (self)
• QString member (self)
• QString path (self)
• QString service (self)
• setArguments (self, list-of-QVariant arguments)
• setAutoStartService (self, bool enable)
• setDelayedReply (self, bool enable)
• QString signature (self)
• MessageType type (self)

Static Methods

• QDBusMessage createError (QString name, QString msg)
• QDBusMessage createError (QDBusError error)
• QDBusMessage createError (QDBusError.ErrorType type, QString msg)
• QDBusMessage createMethodCall (QString service, QString path, QString interface, QString method)
• QDBusMessage createSignal (QString path, QString interface, QString name)

Special Methods

• QDBusMessage __lshift__ (self, QVariant arg)

Detailed Description

该QDBusMessage类表示发送或接收通过D - Bus总线一个消息。

这个对象可以表示任何四个不同类型的消息的（MessageType） ，可以发生在总线上：

• Method calls
• Method return values
• Signal emissions
• Error codes

这种类型的对象与静态创建createError（ ）createMethodCall（）和createSignal（）函数。使用QDBusConnection.send（ ）函数来发送消息。

Type Documentation

QDBusMessage.MessageType

可能的消息类型：

Method Documentation

QDBusMessage.__init__ (self)

构造一个空的，无效的QDBusMessage对象。

See also createError（ ）createMethodCall（）和createSignal（ ） 。

QDBusMessage.__init__ (self, QDBusMessage other)

通过构造特定对象的一个副本other。

注意：QDBusMessage对象是共享的。对副本所做的修改会影响到原来的为好。看setDelayedReply（ ）获取更多信息。

list-of-QVariant QDBusMessage.arguments (self)

返回与将要发送或从D-总线收到的参数列表。

See also setArguments（ ） 。

bool QDBusMessage.autoStartService (self)

返回自动开始标志，以载setAutoStartService（ ） 。默认情况下，此标志为True ，这意味着QtDBus会自动启动服务，如果它尚未运行。

此功能被引入Qt的4.7 。

See also setAutoStartService（ ） 。

QDBusMessage QDBusMessage.createError (QString name, QString msg)

[

构造一个新的乌思消息表示错误，用给定的name和msg。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createError (QDBusError error)

[

构造一个新的乌思消息表示给定error。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createError (QDBusError.ErrorType type, QString msg)

[

构造一个新的乌思消息错误类型type使用消息msg。返回乌思消息。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createErrorReply (self, QString name, QString msg)

[

构造一个新的乌思消息表示错误应答消息，与给定name和msg。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createErrorReply (self, QDBusError error)

[

构造一个新的乌思消息表示错误应答消息，从给定的error对象。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createErrorReply (self, QDBusError.ErrorType type, QString msg)

[

构建了错误类型的新乌思回复消息type使用消息msg。返回乌思消息。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createMethodCall (QString service, QString path, QString interface, QString method)

[

构造一个新的乌思消息表示一个方法调用。一个方法调用总是会通知其目的地地址（service，path，interface和method） 。

该乌思总线允许调用一个给定的远程对象上的方法，而无需指定目的接口，如果方法名是唯一的。然而，如果对远程对象的两个接口导出相同的方法名称，则结果是不确定的（两个中的一个可被称为或错误可以被返回）。

当一个对等情况下（即未在公共汽车上）使用乌思时，service参数是可选的。

]($docs-qdbusmessage.html)

该QDBusObject和QDBusInterface类提供了一个更简单的抽象同步方法调用。

这个函数返回一个QDBusMessage可以与发送对象QDBusConnection.call（ ） 。

QDBusMessage QDBusMessage.createReply (self, list-of-QVariant arguments = QList<QVariant>())

[

构造一个新的消息乌思代表的答复，与给定arguments。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createReply (self, QVariant argument)

[

构造一个新的消息乌思代表的答复，与给定argument。

]($docs-qdbusmessage.html)

QDBusMessage QDBusMessage.createSignal (QString path, QString interface, QString name)

[

构造一个新的消息乌思用给定的path，interface和name，表示信号发射。

一个乌思信号从一个应用程序发出和接收到正在侦听从该接口信号的所有应用程序。

]($docs-qdbusmessage.html)

该QDBusMessage返回的对象可以使用被发送的QDBusConnection.send（）函数。

QString QDBusMessage.errorMessage (self)

返回与接收到的错误相关联的人类可读的消息。

此功能被引入Qt的4.3 。

QString QDBusMessage.errorName (self)

返回接收到的错误的名称。

QString QDBusMessage.interface (self)

返回被调用（在一个方法调用的情况下）的方法，或从接收到的信号的接口。

bool QDBusMessage.isDelayedReply (self)

返回延迟应答标志位，如设置setDelayedReply（ ） 。默认情况下，此标志为False ，这意味着QtDBus有需要时会产生自动回复。

bool QDBusMessage.isReplyRequired (self)

返回标志，指示该消息应该会看到一个回复或没有。这是唯一有意义的method call messages：其他任何类型的消息不能有答复，该函数将始终返回False他们。

QString QDBusMessage.member (self)

返回所发射的信号的名称，或者被调用的方法的名称。

QString QDBusMessage.path (self)

QString QDBusMessage.service (self)

返回该服务的名称或远程方法调用的总线地址。

QDBusMessage.setArguments (self, list-of-QVariant arguments)

设置将要发送的D-Bus的参数arguments。这些将是参数的方法调用或信号中的参数。

See also arguments（ ） 。

QDBusMessage.setAutoStartService (self, bool enable)

设定自动开始标志，以enable。此标志仅是有道理的，方法调用的消息，它讲述了D-Bus的服务器要么自动开始负责服务名称，或不自动启动该服务。

默认情况下，此标志为True ，即服务是自动启动。这意味着：

当这个方法调用被发送到服务已在运行，方法调用被发送给它。如果服务没有运行的是，在D-Bus的守护程序要求自动启动分配给该服务名称服务。这是通过被放置在已知为D- Bus服务器的目录中。服务文件处理。这些文件然后每个都包含一个服务名称和路径时，该服务名称要求应执行的程序。

此功能被引入Qt的4.7 。

See also autoStartService（ ） 。

QDBusMessage.setDelayedReply (self, bool enable)

设置消息是否会被回答后（如果enable是真实的），或者是否应该通过产生一个自动回复QtDBus（如果enable是假的） 。

在D-Bus的，所有方法调用必须产生给调用者的答复，除非调用者明确表示，否则（见isReplyRequired（））。QtDBus自动生成这样的答复为被调用的任何插槽，但它也允许插槽，以表明他们是否会采取发送应答在以后的责任，之后该功能已完成处理。

See also isDelayedReply（）和Delayed Replies。

QString QDBusMessage.signature (self)

返回收到或方法调用的输出参数的信号的签名。

MessageType QDBusMessage.type (self)

[

返回的消息类型。

]($docs-qdbusmessage.html#MessageType-enum)

QDBusMessage QDBusMessage.__lshift__ (self, QVariant arg)