QDBusArgument Class Reference · PyQt4 中文文檔

# QDBusArgument Class Reference ## [[QtDBus](index.htm) module] 該QDBusArgument類用于馬歇爾和demarshall D-Bus的參數。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QDBusArgument?other)` * `__init__ (self, object?arg, int?id?=?QMetaType.Int)` * `add (self, object?arg, int?id?=?QMetaType.Int)` * `beginArray (self, int?id)` * `beginMap (self, int?kid, int?vid)` * `beginMapEntry (self)` * `beginStructure (self)` * `endArray (self)` * `endMap (self)` * `endMapEntry (self)` * `endStructure (self)` * * * ## Detailed Description 在C + +中QDBusArgument類用于馬歇爾和demarshall烏思集合類型，如數組，結構和地圖。在PyQt的值會自動取消編組和QDBusArgument僅用于馬歇爾值。在C + +編組是使用重載的左移運算符。在PyQt的單add（）函數的使用。 * * * ## Method Documentation ``` QDBusArgument.__init__ (self) ``` 構造一個空[QDBusArgument](qdbusargument.html)的說法。空[QDBusArgument](qdbusargument.html)對象不允許進行讀取或寫入。 ``` QDBusArgument.__init__ (self, QDBusArgument?other) ``` 構造的一個副本_other_ [QDBusArgument](qdbusargument.html)對象。因此，這兩個對象將從該點包含相同的狀態前進。 QDBusArguments被明確共享的，因此，任何修改或拷貝將影響其它1太。 ``` QDBusArgument.__init__ (self, object?arg, int?id?=?QMetaType.Int) ``` ``` QDBusArgument.add (self, object?arg, int?id?=?QMetaType.Int) ``` ``` QDBusArgument.beginArray (self, int?id) ``` 打開適用于附加的元類型的元素的新D-Bus的陣列_id_。這個功能通常是用在`operator<<`流媒體運營商，如下面的例子： ``` // append an array of MyElement types [QDBusArgument](qdbusargument.html) &operator<<([QDBusArgument](qdbusargument.html) &argument, const MyArray &myarray) { argument.beginArray( qMetaTypeId<MyElement>() ); for ( int i = 0; i < myarray.length; ++i ) argument << myarray.elements[i]; argument.endArray(); return argument; } ``` 如果你想馬歇爾的類型是[QList](index.htm)，[QVector](index.htm)或任何Qt的[Container Classes](index.htm)這需要一個模板參數，你不必聲明`operator<<`正常吧，因為[QtDBus](index.htm)提供通用模板做編組數據的工作。這同樣適用于STL的序列容器，如`std.list`，`std.vector`等。 **See also** [endArray](qdbusargument.html#endArray)（）[beginStructure](qdbusargument.html#beginStructure)（）和[beginMap](qdbusargument.html#beginMap)（）。 ``` QDBusArgument.beginMap (self, int?kid, int?vid) ``` 打開適用于附加元素的新D-Bus的地圖。地圖是容器相關聯的一個條目（關鍵）到另一個（的價值），如Qt的[QMap](index.htm) or [QHash](index.htm)。地圖上的鍵和值的元類型的ID必須在傳遞_kid_和_vid_分別。這個功能通常是用在`operator<<`流媒體運營商，如下面的例子： ``` // append a dictionary that associates ints to MyValue types [QDBusArgument](qdbusargument.html) &operator<<([QDBusArgument](qdbusargument.html) &argument, const MyDictionary &mydict) { argument.beginMap( [QVariant](qvariant.html).Int, qMetaTypeId<MyValue>() ); for ( int i = 0; i < mydict.length; ++i ) { argument.beginMapEntry(); argument << mydict.data[i].key << mydict.data[i].value; argument.endMapEntry(); } argument.endMap(); return argument; } ``` 如果你想馬歇爾的類型是[QMap](index.htm) or [QHash](index.htm)，你不必聲明`operator<<`正常吧，因為[QtDBus](index.htm)提供通用模板做編組數據的工作。 **See also** [endMap](qdbusargument.html#endMap)（）[beginStructure](qdbusargument.html#beginStructure)（）[beginArray](qdbusargument.html#beginArray)（）和[beginMapEntry](qdbusargument.html#beginMapEntry)（）。 ``` QDBusArgument.beginMapEntry (self) ``` 打開適合的附加鍵和值條目的D-Bus的映射項。當一個圖是打開此功能僅適用[beginMap](qdbusargument.html#beginMap)（）。 See [beginMap](qdbusargument.html#beginMap)（）該函數的使用情況的一個例子。 **See also** [endMapEntry](qdbusargument.html#endMapEntry)（）和[beginMap](qdbusargument.html#beginMap)（）。 ``` QDBusArgument.beginStructure (self) ``` 打開適合追加新的論據了新的D-Bus的結構。這個功能通常是用在`operator<<`流媒體運營商，如下面的例子： ``` [QDBusArgument](qdbusargument.html) &operator<<([QDBusArgument](qdbusargument.html) &argument, const MyStructure &mystruct) { argument.beginStructure(); argument << mystruct.member1 << mystruct.member2 << ... ; argument.endStructure(); return argument; } ``` 結構可以包含其他結構，所以下面的代碼是有效的： ``` [QDBusArgument](qdbusargument.html) &operator<<([QDBusArgument](qdbusargument.html) &argument, const MyStructure &mystruct) { argument.beginStructure(); argument << mystruct.member1 << mystruct.member2; argument.beginStructure(); argument << mystruct.member3.subMember1 << mystruct.member3.subMember2; argument.endStructure(); argument << mystruct.member4; argument.endStructure(); return argument; } ``` **See also** [endStructure](qdbusargument.html#endStructure)（）[beginArray](qdbusargument.html#beginArray)（）和[beginMap](qdbusargument.html#beginMap)（）。 ``` QDBusArgument.endArray (self) ``` 關閉一個D-Bus的數組開[beginArray](qdbusargument.html#beginArray)（）。這個函數必須被調用的次數相同數量的[beginArray](qdbusargument.html#beginArray)（）被調用。 **See also** [beginArray](qdbusargument.html#beginArray)（）[endStructure](qdbusargument.html#endStructure)（）和[endMap](qdbusargument.html#endMap)（）。 ``` QDBusArgument.endMap (self) ``` 關閉一個D-Bus的地圖開[beginMap](qdbusargument.html#beginMap)（）。這個函數必須被調用的次數相同數量的[beginMap](qdbusargument.html#beginMap)（）被調用。 **See also** [beginMap](qdbusargument.html#beginMap)（）[endStructure](qdbusargument.html#endStructure)（）和[endArray](qdbusargument.html#endArray)（）。 ``` QDBusArgument.endMapEntry (self) ``` 關閉開了一個D-Bus的映射項[beginMapEntry](qdbusargument.html#beginMapEntry)（）。這個函數必須被調用的次數相同數量的[beginMapEntry](qdbusargument.html#beginMapEntry)（）被調用。 **See also** [beginMapEntry](qdbusargument.html#beginMapEntry)（）。 ``` QDBusArgument.endStructure (self) ``` 關閉一個D-Bus的結構與開[beginStructure](qdbusargument.html#beginStructure)（）。這個函數必須被調用的次數相同數量的[beginStructure](qdbusargument.html#beginStructure)（）被調用。 **See also** [beginStructure](qdbusargument.html#beginStructure)（）[endArray](qdbusargument.html#endArray)（）和[endMap](qdbusargument.html#endMap)（）。