QDeclarativePropertyMap Class Reference

 #include <QDeclarativePropertyMap>

 // create our data
 QDeclarativePropertyMap ownerData;
 ownerData.insert("name", QVariant(QString("John Smith")));
 ownerData.insert("phone", QVariant(QString("555-5555")));

 // expose it to the UI layer
 QDeclarativeView view;
 QDeclarativeContext *ctxt = view.rootContext();
 ctxt->setContextProperty("owner", &ownerData);

 view.setSource(QUrl::fromLocalFile("main.qml"));
 view.show();

 Text { text: owner.name + " " + owner.phone }

Member Function Documentation

QDeclarativePropertyMap::QDeclarativePropertyMap ( QObject * parent = 0 )

Constructs a bindable map with parent object parent.

QDeclarativePropertyMap::~QDeclarativePropertyMap () [virtual]

Destroys the bindable map.

void QDeclarativePropertyMap::clear ( const QString & key )

Clears the value (if any) associated with key.

bool QDeclarativePropertyMap::contains ( const QString & key ) const

Returns true if the map contains key.

See also size().

int QDeclarativePropertyMap::count () const

This is an overloaded function.

Same as size().

void QDeclarativePropertyMap::insert ( const QString & key, const QVariant & value )

Sets the value associated with key to value.

If the key doesn't exist, it is automatically created.

bool QDeclarativePropertyMap::isEmpty () const

Returns true if the map contains no keys; otherwise returns false.

See also size().

QStringList QDeclarativePropertyMap::keys () const

Returns the list of keys.

Keys that have been cleared will still appear in this list, even though their associated values are invalid QVariants.

int QDeclarativePropertyMap::size () const

Returns the number of keys in the map.

See also isEmpty() and count().

QVariant QDeclarativePropertyMap::value ( const QString & key ) const

Returns the value associated with key.

If no value has been set for this key (or if the value has been cleared), an invalid QVariant is returned.

void QDeclarativePropertyMap::valueChanged ( const QString & key, const QVariant & value ) [signal]

This signal is emitted whenever one of the values in the map is changed. key is the key corresponding to the value that was changed.

Note: valueChanged() is NOT emitted when changes are made by calling insert() or clear() - it is only emitted when a value is updated from QML.

QVariant & QDeclarativePropertyMap::operator[] ( const QString & key )

Returns the value associated with the key key as a modifiable reference.

If the map contains no item with key key, the function inserts an invalid QVariant into the map with key key, and returns a reference to it.

See also insert() and value().

QVariant QDeclarativePropertyMap::operator[] ( const QString & key ) const

This is an overloaded function.

Same as value().