QDBusAbstractInterface Class Reference · PyQt4 中文文檔

# QDBusAbstractInterface Class Reference ## [[QtDBus](index.htm) module] 該QDBusAbstractInterface類是在所有的D-Bus接口的基類[QtDBus](index.htm)對遠程接口綁定，允許訪問[More...](#details) 繼承[QObject](qobject.html)。通過繼承[QDBusConnectionInterface](qdbusconnectioninterface.html)和[QDBusInterface](qdbusinterface.html)。 ### Methods * `__init__ (self, QString?service, QString?path, str?interface, QDBusConnection?connection, QObject?parent)` * `QDBusPendingCall asyncCall (self, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant())` * `QDBusPendingCall asyncCallWithArgumentList (self, QString?method, list-of-QVariant?args)` * `QDBusMessage call (self, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant())` * `QDBusMessage call (self, QDBus.CallMode?mode, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant())` * `QDBusMessage callWithArgumentList (self, QDBus.CallMode?mode, QString?method, list-of-QVariant?args)` * `bool callWithCallback (self, QString?method, list-of-QVariant?args, QObject?receiver, SLOT()?returnMethod, SLOT()?errorMethod)` * `object callWithCallback (self, QString?method, list-of-QVariant?args, callable?returnMethod, callable?errorMethod)` * `bool callWithCallback (self, QString?method, list-of-QVariant?args, QObject?receiver, SLOT()?slot)` * `object callWithCallback (self, QString?method, list-of-QVariant?args, callable?slot)` * `QDBusConnection connection (self)` * `connectNotify (self, SIGNAL()?signal)` * `disconnectNotify (self, SIGNAL()?signal)` * `QString interface (self)` * `bool isValid (self)` * `QDBusError lastError (self)` * `QString path (self)` * `QString service (self)` * `setTimeout (self, int?timeout)` * `int timeout (self)` * * * ## Detailed Description 該QDBusAbstractInterface類是在所有的D-Bus接口的基類[QtDBus](index.htm)對遠程接口綁定，允許訪問生成的代碼類也從QDBusAbstractInterface派生，這里所描述的所有方法也適用于生成代碼的類。除了這里描述的那些生成代碼的類提供對遠程方法的成員函數，它允許對正確的參數編譯時檢查和返回值，以及物業類型匹配和信號參數匹配。 * * * ## Method Documentation ``` QDBusAbstractInterface.__init__ (self, QString?service, QString?path, str?interface, QDBusConnection?connection, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 ``` QDBusPendingCall QDBusAbstractInterface.asyncCall (self, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant()) ``` [ 調用該方法_method_在該接口上，并傳遞參數給此函數的方法。 ](qdbuspendingcall.html) [的參數，以`call`被傳遞到通過D-Bus的遠程函數作為輸入參數。返回](qdbuspendingcall.html)[QDBusPendingCall](qdbuspendingcall.html)對象可以用來了解的回復信息。此功能可與多達8個參數，在參數傳遞中使用_arg1_，_arg2_，_arg3_，_arg4_，_arg5_，_arg6_，_arg7_和_arg8_。如果您需要超過8個參數，或者如果你有一個可變數目的參數傳遞，使用[asyncCallWithArgumentList](qdbusabstractinterface.html#asyncCallWithArgumentList)（）。它可用于以下方式： ``` [QString](qstring.html) value = retrieveValue(); [QDBusPendingCall](qdbuspendingcall.html) pcall = interface->asyncCall(QLatin1String("Process"), value); [QDBusPendingCallWatcher](qdbuspendingcallwatcher.html) *watcher = new [QDBusPendingCallWatcher](qdbuspendingcallwatcher.html)(pcall, this); [QObject](qobject.html).connect(watcher, SIGNAL(finished([QDBusPendingCallWatcher](qdbuspendingcallwatcher.html)*)), this, SLOT(callFinishedSlot([QDBusPendingCallWatcher](qdbuspendingcallwatcher.html)*))); ``` 這個例子說明了函數調用與0 ， 1??和2的參數，并說明在每個傳遞不同的參數類型（第一通電話`"ProcessWorkUnicode"`將包含一個Unicode字符串，第二次調用`"ProcessWork"`將包含一個字符串和一個字節數組）。此功能被引入Qt的4.5 。 ``` QDBusPendingCall QDBusAbstractInterface.asyncCallWithArgumentList (self, QString?method, list-of-QVariant?args) ``` [](qdbuspendingcall.html) [由地方指定調用遠程方法_method_在該接口上，使用_args_作為參數。這個函數返回一個](qdbuspendingcall.html)[QDBusPendingCall](qdbuspendingcall.html)對象，該對象可以被用來跟蹤答復的狀態，一旦它已經到達訪問其內容。通常情況下，你應該使用撥打電話[asyncCall](qdbusabstractinterface.html#asyncCall)（）。 **Note:**這個功能是[thread-safe](index.htm#thread-safe)。此功能被引入Qt的4.5 。 ``` QDBusMessage QDBusAbstractInterface.call (self, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant()) ``` [ 調用該方法_method_在該接口上，并傳遞參數給此函數的方法。 ](qdbusmessage.html) [的參數，以`call`被傳遞到通過D-Bus的遠程函數作為輸入參數。輸出參數中返回的](qdbusmessage.html)[QDBusMessage](qdbusmessage.html)回復。如果回答是錯誤的答復，[lastError](qdbusabstractinterface.html#lastError)（）也將被設置到該錯誤消息的內容。此功能可與多達8個參數，在參數傳遞中使用_arg1_，_arg2_，_arg3_，_arg4_，_arg5_，_arg6_，_arg7_和_arg8_。如果您需要超過8個參數，或者如果你有一個可變數目的參數傳遞，使用[callWithArgumentList](qdbusabstractinterface.html#callWithArgumentList)（）。它可用于以下方式： ``` [QString](qstring.html) value = retrieveValue(); [QDBusMessage](qdbusmessage.html) reply; [QDBusReply](qdbusreply.html)<int> api = interface->call(QLatin1String("GetAPIVersion")); if (api >= 14) reply = interface->call(QLatin1String("ProcessWorkUnicode"), value); else reply = interface->call(QLatin1String("ProcessWork"), QLatin1String("UTF-8"), value.toUtf8()); ``` 這個例子說明了函數調用與0 ， 1??和2的參數，并說明在每個傳遞不同的參數類型（第一通電話`"ProcessWorkUnicode"`將包含一個Unicode字符串，第二次調用`"ProcessWork"`將包含一個字符串和一個字節數組）。 ``` QDBusMessage QDBusAbstractInterface.call (self, QDBus.CallMode?mode, QString?method, QVariant?arg1?=?QVariant(), QVariant?arg2?=?QVariant(), QVariant?arg3?=?QVariant(), QVariant?arg4?=?QVariant(), QVariant?arg5?=?QVariant(), QVariant?arg6?=?QVariant(), QVariant?arg7?=?QVariant(), QVariant?arg8?=?QVariant()) ``` [ 這是一個重載函數。調用該方法_method_在該接口上，并傳遞參數給此函數的方法。如果_mode_ is `NoWaitForReply`，那么這個功能將發出呼叫后立即返回，而不等待來自遠程方法的答復。否則，_mode_表示該功能是否應該啟動了Qt事件循環在等待答復的到來。 ](qdbusmessage.html) [此功能可與多達8個參數，在參數傳遞中使用_arg1_，_arg2_，_arg3_，_arg4_，_arg5_，_arg6_，_arg7_和_arg8_。如果您需要超過8個參數，或者如果你有一個可變數目的參數傳遞，使用](qdbusmessage.html)[callWithArgumentList](qdbusabstractinterface.html#callWithArgumentList)（）。如果此功能重新進入Qt的事件循環，以等待答復，這將排除用戶輸入。在等待期間，它可能會帶來信號和其他方法調用您的應用程序。因此，它必須準備處理重入每當一個呼叫被置于與[call](qdbusabstractinterface.html#call)（）。 ``` QDBusMessage QDBusAbstractInterface.callWithArgumentList (self, QDBus.CallMode?mode, QString?method, list-of-QVariant?args) ``` [](qdbusmessage.html) [由地方指定調用遠程方法_method_在該接口上，使用_args_作為參數。這個函數返回接收的答復消息，它可以是一個正常的](qdbusmessage.html)[QDBusMessage.ReplyMessage](qdbusmessage.html#MessageType-enum)（表示成功）或[QDBusMessage.ErrorMessage](qdbusmessage.html#MessageType-enum)（如果調用失敗）。該_mode_參數指定如何調用應放置。如果調用成功，[lastError](qdbusabstractinterface.html#lastError)（）將被清零，否則，它會包含這個調用產生的誤差。通常情況下，你應該使用撥打電話[call](qdbusabstractinterface.html#call)（）。 **Warning:**如果你使用`UseEventLoop`，您的代碼必須準備好應對任何重入：其他方法調用和信號，可能這個函數返回前交付，以及其他排隊Qt的信號和事件。 **Note:**這個功能是[thread-safe](index.htm#thread-safe)。 ``` bool QDBusAbstractInterface.callWithCallback (self, QString?method, list-of-QVariant?args, QObject?receiver, SLOT()?returnMethod, SLOT()?errorMethod) ``` 由地方指定調用遠程方法_method_在該接口上，使用_args_作為參數。排隊的呼叫后，立即這個函數返回。從遙控功能的答復被傳遞到_returnMethod_對象_receiver_。如果發生錯誤，則_errorMethod_對象_receiver_被稱為代替。如果排隊成功，該函數返回True。這并不表示該執行調用成功。如果失敗，則_errorMethod_被調用。如果排隊失敗，這個函數返回False ，沒有插槽將被調用。該_returnMethod_必須有作為它的參數的函數調用返回的類型。任選地，它可具有[QDBusMessage](qdbusmessage.html)參數作為它的最后一個或唯一的參數。該_errorMethod_必須有一個[QDBusError](qdbuserror.html)作為其唯一的參數。此功能被引入Qt的4.3 。 **See also** [QDBusError](qdbuserror.html)和[QDBusMessage](qdbusmessage.html)。 ``` object QDBusAbstractInterface.callWithCallback (self, QString?method, list-of-QVariant?args, callable?returnMethod, callable?errorMethod) ``` 這是一個重載函數。此功能已被棄用。請使用重載版本。由地方指定調用遠程方法_method_在該接口上，使用_args_作為參數。排隊的呼叫后，立即這個函數返回。從遠程功能或所發出任何錯誤的回復被傳遞到_slot_插槽上的對象_receiver_。如果排隊成功該函數返回True ：它并不表示調用成功。如果它失敗了，該槽被調用并顯示一條錯誤消息。[lastError](qdbusabstractinterface.html#lastError)（）將不會在這些情況下設定。 **See also** [QDBusError](qdbuserror.html)和[QDBusMessage](qdbusmessage.html)。 ``` bool QDBusAbstractInterface.callWithCallback (self, QString?method, list-of-QVariant?args, QObject?receiver, SLOT()?slot) ``` ``` object QDBusAbstractInterface.callWithCallback (self, QString?method, list-of-QVariant?args, callable?slot) ``` ``` QDBusConnection QDBusAbstractInterface.connection (self) ``` [ 返回此接口assocated與連接。 ``` QDBusAbstractInterface.connectNotify (self, SIGNAL()?signal) ``` ``` QDBusAbstractInterface.disconnectNotify (self, SIGNAL()?signal) ``` ``` QString QDBusAbstractInterface.interface (self) ``` 返回此接口的名稱。 ``` bool QDBusAbstractInterface.isValid (self) ``` 返回True如果這是一個有效的參考遠程對象。如果創建這個接口的（例如，如果遠程應用程序不存在）期間發生了錯誤，則返回False 。 ](qdbusconnection.html) [注意：當與遠程對象時，它并不總是可能的，以確定它創建時存在一個](qdbusconnection.html)[QDBusInterface](qdbusinterface.html)。 ``` QDBusError QDBusAbstractInterface.lastError (self) ``` [ 返回錯誤產生的最后一個操作，或無效的錯誤，如果上次操作沒有產生一個錯誤。 ``` QString QDBusAbstractInterface.path (self) ``` ``` QString QDBusAbstractInterface.service (self) ``` 返回該接口相關聯的服務的名稱。 ``` QDBusAbstractInterface.setTimeout (self, int?timeout) ``` 設置以毫秒為單位的超時以后所有烏思調用_timeout_。 -1表示默認烏思超時時間（通常為25秒）。此功能被引入Qt的4.8 。 ](qdbuserror.html) [**See also**](qdbuserror.html) [timeout](qdbusabstractinterface.html#timeout)（）。 ``` int QDBusAbstractInterface.timeout (self) ``` 返回以毫秒為單位的超時時間的當前值。 -1表示默認烏思超時時間（通常為25秒）。此功能被引入Qt的4.8 。 **See also** [setTimeout](qdbusabstractinterface.html#setTimeout)（）。