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 が含まれていれば真を返す。

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 から提供された値がinput である場合、QML からのプロパティへの更新をインターセプトするために用意されています。

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

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

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

このキーに値が設定されていない場合（または値がクリアされている場合）、無効なQVariant が返される。

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