# QDeclarativePropertyMap Class Reference ## [[QtDeclarative](index.htm) module] 該QDeclarativePropertyMap類允許您設置，可以在QML綁定使用鍵 - 值對。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `clear (self, QString?key)` * `bool contains (self, QString?key)` * `int count (self)` * `insert (self, QString?key, QVariant?value)` * `bool isEmpty (self)` * `QStringList keys (self)` * `int size (self)` * `QVariant value (self, QString?key)` ### Special Methods * `QVariant __getitem__ (self, QString?key)` * `__len__ (self)` ### Qt Signals * `void valueChanged (const QString&,const QVariant&)` * * * ## Detailed Description 該QDeclarativePropertyMap類允許您設置，可以在QML綁定使用鍵 - 值對。 QDeclarativePropertyMap提供了一個方便的方式來域數據暴露給UI層。下面的例子顯示了如何聲明在C + +的數據，然后訪問它的QML 。 在C + +中的文件： ``` // create our data QDeclarativePropertyMap ownerData; ownerData.insert("name", [QVariant](qvariant.html)([QString](qstring.html)("John Smith"))); ownerData.insert("phone", [QVariant](qvariant.html)([QString](qstring.html)("555-5555"))); // expose it to the UI layer [QDeclarativeView](qdeclarativeview.html) view; [QDeclarativeContext](qdeclarativecontext.html) *ctxt = view.rootContext(); ctxt->setContextProperty("owner", &ownerData); view.setSource([QUrl](qurl.html).fromLocalFile("main.qml")); view.show(); ``` 然后，在`main.qml`： ``` Text { text: owner.name + " " + owner.phone } ``` 綁定是動態的 - 每當一個鍵的值被更新，什么都綁定到該密鑰將更新。 為了檢測在UI層做值的變化可以連接到[valueChanged](qdeclarativepropertymap.html#valueChanged)（）信號。但是請注意，[valueChanged](qdeclarativepropertymap.html#valueChanged)（）是**NOT**更改時通過調用發出的制作[insert](qdeclarativepropertymap.html#insert)（）或[clear](qdeclarativepropertymap.html#clear)（） - 它是僅當一個值被從QML更新射出。 **Note:**這是不可能的，從地圖中刪除鍵，一旦一個密鑰被添加，你只能修改或清除其關聯的值。 * * * ## Method Documentation ``` QDeclarativePropertyMap.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個可綁定的地圖與父對象_parent_。 ``` QDeclarativePropertyMap.clear (self, QString?key) ``` 清除值（如果有的話）與關聯_key_。 ``` bool QDeclarativePropertyMap.contains (self, QString?key) ``` 如果地圖包含，則返回True_key_。 **See also** [size](qdeclarativepropertymap.html#size)（ ） 。 ``` int QDeclarativePropertyMap.count (self) ``` 這是一個重載函數。 同[size](qdeclarativepropertymap.html#size)（ ） 。 ``` QDeclarativePropertyMap.insert (self, QString?key, QVariant?value) ``` 設置關聯的值_key_至_value_。 如果該鍵不存在，則會自動創建。 ``` bool QDeclarativePropertyMap.isEmpty (self) ``` 返回True如果映射不包含鍵，否則返回False 。 **See also** [size](qdeclarativepropertymap.html#size)（ ） 。 ``` QStringList QDeclarativePropertyMap.keys (self) ``` 返回鍵的列表。 已清除鍵仍然會出現在這個列表中，即使它們相關的值是無效的[QVariants](index.htm#qvariants)。 ``` int QDeclarativePropertyMap.size (self) ``` 返回鍵映射中的號碼。 **See also** [isEmpty](qdeclarativepropertymap.html#isEmpty)（）和[count](qdeclarativepropertymap.html#count)（ ） 。 ``` QVariant QDeclarativePropertyMap.value (self, QString?key) ``` 返回與關聯的值_key_。 如果沒有值被設置為這個鍵（或如果該值已被清除） ，無效[QVariant](qvariant.html)返回。 ``` QVariant QDeclarativePropertyMap.__getitem__ (self, QString?key) ``` ``` QDeclarativePropertyMap.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void valueChanged (const QString&,const QVariant&) ``` 這是該信號的默認超載。 這個信號被發射時在地圖中的一個值被改變。_key_是對應于該鍵_value_已更改。 **Note:**的valueChanged （）是**NOT**更改時通過調用發出的制作[insert](qdeclarativepropertymap.html#insert)（）或[clear](qdeclarativepropertymap.html#clear)（） - 它是僅當一個值被從QML更新射出。