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

맵에 키가 없는 경우 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

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 와 연관된 값을 반환합니다.

이 키에 설정된 값이 없거나 값이 지워진 경우 잘못된 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()와 동일합니다.