# QDeclarativeListReference Class Reference ## [[QtDeclarative](index.htm) module] 該QDeclarativeListReference類允許的操作[QDeclarativeListProperty](index.htm)屬性。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QObject, str?property, QDeclarativeEngine?engine?=?None)` * `__init__ (self, QDeclarativeListReference)` * `bool append (self, QObject)` * `QObject at (self, int)` * `bool canAppend (self)` * `bool canAt (self)` * `bool canClear (self)` * `bool canCount (self)` * `bool clear (self)` * `int count (self)` * `bool isValid (self)` * `QMetaObject listElementType (self)` * `QObject object (self)` * * * ## Detailed Description 該QDeclarativeListReference類允許的操作[QDeclarativeListProperty](index.htm)屬性。 QDeclarativeListReference允許C + +程序來讀取，并在一個簡單的和類型安全的方式賦值到一個QML列表屬性。一個QDeclarativeListReference可以通過傳遞一個對象和屬性名或通過創建一個[QDeclarativeProperty](qdeclarativeproperty.html)實例。這兩個是equivalant ： ``` QDeclarativeListReference ref1(object, "children"); [QDeclarativeProperty](qdeclarativeproperty.html) ref2(object, "children"); QDeclarativeListReference ref2 = qvariant_cast<QDeclarativeListReference>(ref2.read()); ``` 不是所有的QML列表屬性支持所有操作。一組方法，[canAppend](qdeclarativelistreference.html#canAppend)（ ）[canAt](qdeclarativelistreference.html#canAt)（ ）[canClear](qdeclarativelistreference.html#canClear)（）和[canCount](qdeclarativelistreference.html#canCount)（）允許程序查詢的操作是否被支撐在一個給定的屬性。 QML列表屬性是類型安全的。只[QObject](qobject.html)就這么從正確的基類派生可以分配到列表中。該[listElementType](qdeclarativelistreference.html#listElementType)（ ）方法可用于查詢[QMetaObject](qmetaobject.html)的[QObject](qobject.html)輸入的支持。嘗試了不正確類型的對象添加到一個列表屬性將失敗。 像正常的列表，通過訪問索引列表元素時，它是調用者的責任，以確保它不會使用要求進行超出范圍的元素[count](qdeclarativelistreference.html#count)前（ ）方法調用[at](qdeclarativelistreference.html#at)（ ） 。 * * * ## Method Documentation ``` QDeclarativeListReference.__init__ (self) ``` 構造一個無效的實例。 ``` QDeclarativeListReference.__init__ (self, QObject, str?property, QDeclarativeEngine?engine?=?None) ``` 構造一個[QDeclarativeListReference](qdeclarativelistreference.html)為_object_的_property_。如果_property_是不是一個列表屬性，無效[QDeclarativeListReference](qdeclarativelistreference.html)被創建。如果_object_參考構造被破壞后，它會自動失效。也就是說，它是安全的保持[QDeclarativeListReference](qdeclarativelistreference.html)即使實例_object_被刪除。 路過_engine_需要訪問一些創建QML列表屬性。如果有疑問，和發動機可用，它傳遞。 ``` QDeclarativeListReference.__init__ (self, QDeclarativeListReference) ``` ``` bool QDeclarativeListReference.append (self, QObject) ``` 追加可_object_到列表中。返回True如果操作成功，否則為False 。 **See also** [canAppend](qdeclarativelistreference.html#canAppend)（ ） 。 ``` QObject QDeclarativeListReference.at (self, int) ``` [ 返回的列表元素_index_，或者0，如果操作失敗。 ](qobject.html) [**See also**](qobject.html) [canAt](qdeclarativelistreference.html#canAt)（ ） 。 ``` bool QDeclarativeListReference.canAppend (self) ``` 返回True如果列表屬性可以附加到，否則為False。返回False，如果引用是無效的。 **See also** [append](qdeclarativelistreference.html#append)（ ） 。 ``` bool QDeclarativeListReference.canAt (self) ``` 返回True如果列表屬性可以通過索引查詢，否則為False 。返回False，如果引用是無效的。 **See also** [at](qdeclarativelistreference.html#at)（ ） 。 ``` bool QDeclarativeListReference.canClear (self) ``` 返回True如果列表屬性可以被清除，否則為False。返回False，如果引用是無效的。 **See also** [clear](qdeclarativelistreference.html#clear)（ ） 。 ``` bool QDeclarativeListReference.canCount (self) ``` 返回True如果列表屬性可以查詢其元素計數，否則為False 。返回False，如果引用是無效的。 **See also** [count](qdeclarativelistreference.html#count)（ ） 。 ``` bool QDeclarativeListReference.clear (self) ``` 清除列表。返回True如果操作成功，否則為False 。 **See also** [canClear](qdeclarativelistreference.html#canClear)（ ） 。 ``` int QDeclarativeListReference.count (self) ``` 返回對象列表中的號碼，或者0，如果操作失敗。 ``` bool QDeclarativeListReference.isValid (self) ``` 返回True如果該實例是指一個有效的列表屬性，否則為False 。 ``` QMetaObject QDeclarativeListReference.listElementType (self) ``` [](qmetaobject.html) [返回](qmetaobject.html)[QMetaObject](qmetaobject.html)為存儲在列表屬性的元素。返回0，如果引用是無效的。 該[QMetaObject](qmetaobject.html)可以使用的時間提前，以確定一個給定實例是否可以被添加到列表。 ``` QObject QDeclarativeListReference.object (self) ``` [ 返回列表屬性的對象。返回0，如果引用是無效的。 ](qobject.html)