QQmlPropertyMap Class

// 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 }

メンバ関数の説明

[explicit] QQmlPropertyMap::QQmlPropertyMap(QObject *parent = nullptr)

親オブジェクトparent を持つバインド可能なマップを構築します。

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

親オブジェクトを持つバインド可能なマップを構築しますparent 。このコンストラクタは QQmlPropertyMap から派生したクラスで使用します。

derived の型は、メタオブジェクトシステムにプロパティマップを登録するために使用されます。これは、派生クラスのプロパティに確実にアクセスできるようにするために必要です。この型はQQmlPropertyMapから派生したものでなければなりません。

[override virtual 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() と同じ。

[since 6.1] void QQmlPropertyMap::freeze()

このプロパティ・マップへのプロパティの追加を禁止します。既存のプロパティは変更またはクリアできます。

その代わり、既存のプロパティの内部キャッシュがオンになり、QML からのアクセスが速くなる可能性があります。

この関数は Qt 6.1 で導入されました。

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

QQmlPropertyMap にvalues を挿入します。

存在しないキーは自動的に作成されます。

この方法は、insert(key, value) を連続して何度も呼び出すよりもかなり高速です。

この関数は Qt 6.1 で導入されました。

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

key に関連付けられた値をvalue に設定します。

キーが存在しない場合は、自動的に作成されます。

bool QQmlPropertyMap::isEmpty() const

マップにキーがない場合はtrueを返し、そうでない場合はfalseを返します。

size()も参照してください 。

[invokable] QStringList QQmlPropertyMap::keys() const

キーのリストを返します。

クリアされたキーは、関連する値が無効な QVariants であっても、このリストに表示されます。

int QQmlPropertyMap::size() const

マップ内のキーの数を返します。

isEmpty() およびcount()も参照して ください。

[virtual protected] QVariant QQmlPropertyMap::updateValue(const QString &key, const QVariant &input)

キーkey に格納される新しい値を返します。この関数は QML からのプロパティへの更新をインターセプトするために提供されます。 QML から提供される値はinput です。

この関数をオーバーライドして、更新されたプロパティ値を操作することができます。この関数は QML から値が更新されたときのみ呼び出されることに注意してください。

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

key に関連付けられた値を返します。

このキーに値が設定されていない(あるいは値がクリアされている)場合、 invalidQVariant が返されます。

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

key は変更されたvalue に対応するキーです。

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

変更可能な参照として、キーkey に関連づけられた値を返します。

マップにキーkey を持つ項目がない場合、この関数は無効なQVariant をキーkey を持つマップに挿入し、その参照を返します。

insert() およびvalue()も参照のこと 。

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

これはオーバーロードされた関数です。

value() と同じです。