QQmlPropertyMap类

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

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

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

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

成员函数文档

[显式] QQmlPropertyMap::QQmlPropertyMap(QObject *parent = nullptr)

使用父对象parent构建一个可绑定映射。

[保护] template <typename DerivedType> QQmlPropertyMap::QQmlPropertyMap(DerivedType *derived, QObject *parent)

使用父对象parent构建一个可绑定映射。在从QQmlPropertyMap派生的类中使用此构造函数。

将derived的类型用于将属性映射注册到元对象系统，这是确保派生类的属性可访问所必需的。此类型必须从QQmlPropertyMap派生。

[覆盖虚拟noexcept] QQmlPropertyMap::~QQmlPropertyMap()

销毁可绑定映射。

void QQmlPropertyMap::clear(const QString &key)

清除与key关联的值（如果存在）。

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

如果映射包含key，则返回true。

另请参阅size()。

int QQmlPropertyMap::count() const

这是一个重载的函数。

等同于size()。

[自6.1起] void QQmlPropertyMap::freeze()

不允许将任何更多属性添加到此属性映射。现有的属性可以修改或清除。

相应地，会开启现有属性的内联缓存，这可能会导致从QML访问更快。

此函数在Qt 6.1中引入。

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

将与key关联的值设置为value。

如果键不存在，则自动创建。

[自6.1起] void QQmlPropertyMap::insert(const QVariantHash &values)

将值插入到QQmlPropertyMap。

不存在的键会自动创建。

这个方法比多次连续调用insert(key, value)要快得多。

此函数在Qt 6.1中引入。

bool QQmlPropertyMap::isEmpty() const

如果该映射不包含任何键，则返回true；否则返回false。

另请参阅size()。

[可调用] QStringList QQmlPropertyMap::keys() const

返回键的列表。

即使关联的值是无效的QVariants，也已经清除的键仍会出现在此列表中。

int QQmlPropertyMap::size() const

返回映射中的键的数量。

另请参阅isEmpty()和count。

[虚受保护] QVariant QQmlPropertyMap::updateValue(const QString &key, const QVariant &input)

返回应存储与键key相关的新值。此函数提供用于截获从QML提供的值（即input）的属性更新。

重写此函数以更改属性值。请注意，此函数仅在值从QML更新时调用。

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

返回与关键key相关联的值。

如果没有设置此键的值（或者如果已清除值），则返回无效的QVariant。

[信号] void QQmlPropertyMap::valueChanged(const QString &key, const QVariant &value)

每当映射中的一个值发生变化时，都会发出此信号。key是已更改值的对应键。

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

返回与关键key相关联的值的可修改引用。

如果映射中不包含与关键key相关联的项目，则该函数会在映射中将无效的QVariant插入到关键key，并返回对其的引用。

另请参阅insert()和value。

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

这是一个重载的函数。

与value()相同。