QDBusMessage Class Reference · PyQt4 中文文檔

# QDBusMessage Class Reference ## [[QtDBus](index.htm) module] 該QDBusMessage類表示發送或接收通過D - Bus總線一個消息。[More...](#details) ### 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](qdbusmessage.html#MessageType-enum)），可以發生在總線上： * Method calls * Method return values * Signal emissions * Error codes 這種類型的對象與靜態創建[createError](qdbusmessage.html#createError)（）[createMethodCall](qdbusmessage.html#createMethodCall)（）和[createSignal](qdbusmessage.html#createSignal)（）函數。使用[QDBusConnection.send](qdbusconnection.html#send)（）函數來發送消息。 * * * ## Type Documentation ``` QDBusMessage.MessageType ``` 可能的消息類型： | Constant | Value | Description | | --- | --- | --- | | `QDBusMessage.MethodCallMessage` | `1` | 較傳出或傳入方法調用的消息 | | `QDBusMessage.SignalMessage` | `4` | 較傳出或傳入信號發射的消息 | | `QDBusMessage.ReplyMessage` | `2` | 表示方法調用的返回值的消息 | | `QDBusMessage.ErrorMessage` | `3` | 表示響應于一個方法調用的錯誤狀態的信息 | | `QDBusMessage.InvalidMessage` | `0` | 無效的消息：這是從來沒有從D-Bus的收到的郵件設置 | * * * ## Method Documentation ``` QDBusMessage.__init__ (self) ``` 構造一個空的，無效的[QDBusMessage](qdbusmessage.html)對象。 **See also** [createError](qdbusmessage.html#createError)（）[createMethodCall](qdbusmessage.html#createMethodCall)（）和[createSignal](qdbusmessage.html#createSignal)（）。 ``` QDBusMessage.__init__ (self, QDBusMessage?other) ``` 通過構造特定對象的一個副本_other_。注意：[QDBusMessage](qdbusmessage.html)對象是共享的。對副本所做的修改會影響到原來的為好。看[setDelayedReply](qdbusmessage.html#setDelayedReply)（）獲取更多信息。 ``` list-of-QVariant QDBusMessage.arguments (self) ``` 返回與將要發送或從D-總線收到的參數列表。 **See also** [setArguments](qdbusmessage.html#setArguments)（）。 ``` bool QDBusMessage.autoStartService (self) ``` 返回自動開始標志，以載[setAutoStartService](qdbusmessage.html#setAutoStartService)（）。默認情況下，此標志為True ，這意味著[QtDBus](index.htm)會自動啟動服務，如果它尚未運行。此功能被引入Qt的4.7 。 **See also** [setAutoStartService](qdbusmessage.html#setAutoStartService)（）。 ``` QDBusMessage QDBusMessage.createError (QString?name, QString?msg) ``` [ 構造一個新的烏思消息表示錯誤，用給定的_name_和_msg_。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createError (QDBusError?error) ``` [ 構造一個新的烏思消息表示給定_error_。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createError (QDBusError.ErrorType?type, QString?msg) ``` [ 構造一個新的烏思消息錯誤類型_type_使用消息_msg_。返回烏思消息。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createErrorReply (self, QString?name, QString?msg) ``` [ 構造一個新的烏思消息表示錯誤應答消息，與給定_name_和_msg_。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createErrorReply (self, QDBusError?error) ``` [ 構造一個新的烏思消息表示錯誤應答消息，從給定的_error_對象。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createErrorReply (self, QDBusError.ErrorType?type, QString?msg) ``` [ 構建了錯誤類型的新烏思回復消息_type_使用消息_msg_。返回烏思消息。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createMethodCall (QString?service, QString?path, QString?interface, QString?method) ``` [ 構造一個新的烏思消息表示一個方法調用。一個方法調用總是會通知其目的地地址（_service_，_path_，_interface_和_method_）。該烏思總線允許調用一個給定的遠程對象上的方法，而無需指定目的接口，如果方法名是唯一的。然而，如果對遠程對象的兩個接口導出相同的方法名稱，則結果是不確定的（兩個中的一個可被稱為或錯誤可以被返回）。當一個對等情況下（即未在公共汽車上）使用烏思時，_service_參數是可選的。 ](qdbusmessage.html) [該QDBusObject和](qdbusmessage.html)[QDBusInterface](qdbusinterface.html)類提供了一個更簡單的抽象同步方法調用。這個函數返回一個[QDBusMessage](qdbusmessage.html)可以與發送對象[QDBusConnection.call](qdbusconnection.html#call)（）。 ``` QDBusMessage QDBusMessage.createReply (self, list-of-QVariant?arguments?=?QList<QVariant>()) ``` [ 構造一個新的消息烏思代表的答復，與給定_arguments_。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createReply (self, QVariant?argument) ``` [ 構造一個新的消息烏思代表的答復，與給定_argument_。 ](qdbusmessage.html) ``` QDBusMessage QDBusMessage.createSignal (QString?path, QString?interface, QString?name) ``` [ 構造一個新的消息烏思用給定的_path_，_interface_和_name_，表示信號發射。一個烏思信號從一個應用程序發出和接收到正在偵聽從該接口信號的所有應用程序。 ](qdbusmessage.html) [該](qdbusmessage.html)[QDBusMessage](qdbusmessage.html)返回的對象可以使用被發送的[QDBusConnection.send](qdbusconnection.html#send)（）函數。 ``` QString QDBusMessage.errorMessage (self) ``` 返回與接收到的錯誤相關聯的人類可讀的消息。此功能被引入Qt的4.3 。 ``` QString QDBusMessage.errorName (self) ``` 返回接收到的錯誤的名稱。 ``` QString QDBusMessage.interface (self) ``` 返回被調用（在一個方法調用的情況下）的方法，或從接收到的信號的接口。 ``` bool QDBusMessage.isDelayedReply (self) ``` 返回延遲應答標志位，如設置[setDelayedReply](qdbusmessage.html#setDelayedReply)（）。默認情況下，此標志為False ，這意味著[QtDBus](index.htm)有需要時會產生自動回復。 ``` bool QDBusMessage.isReplyRequired (self) ``` 返回標志，指示該消息應該會看到一個回復或沒有。這是唯一有意義的[method call messages](qdbusmessage.html#MessageType-enum)：其他任何類型的消息不能有答復，該函數將始終返回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.html#arguments)（）。 ``` QDBusMessage.setAutoStartService (self, bool?enable) ``` 設定自動開始標志，以_enable_。此標志僅是有道理的，方法調用的消息，它講述了D-Bus的服務器要么自動開始負責服務名稱，或不自動啟動該服務。默認情況下，此標志為True ，即服務是自動啟動。這意味著：當這個方法調用被發送到服務已在運行，方法調用被發送給它。如果服務沒有運行的是，在D-Bus的守護程序要求自動啟動分配給該服務名稱服務。這是通過被放置在已知為D- Bus服務器的目錄中。服務文件處理。這些文件然后每個都包含一個服務名稱和路徑時，該服務名稱要求應執行的程序。此功能被引入Qt的4.7 。 **See also** [autoStartService](qdbusmessage.html#autoStartService)（）。 ``` QDBusMessage.setDelayedReply (self, bool?enable) ``` 設置消息是否會被回答后（如果_enable_是真實的），或者是否應該通過產生一個自動回復[QtDBus](index.htm)（如果_enable_是假的）。在D-Bus的，所有方法調用必須產生給調用者的答復，除非調用者明確表示，否則（見[isReplyRequired](qdbusmessage.html#isReplyRequired)（））。[QtDBus](index.htm)自動生成這樣的答復為被調用的任何插槽，但它也允許插槽，以表明他們是否會采取發送應答在以后的責任，之后該功能已完成處理。 **See also** [isDelayedReply](qdbusmessage.html#isDelayedReply)（）和[Delayed Replies](index.htm#delayed-replies)。 ``` QString QDBusMessage.signature (self) ``` 返回收到或方法調用的輸出參數的信號的簽名。 ``` MessageType QDBusMessage.type (self) ``` [ 返回的消息類型。 ](qdbusmessage.html#MessageType-enum) ``` QDBusMessage QDBusMessage.__lshift__ (self, QVariant?arg) ``` [](qdbusmessage.html)