QQmlPropertyMap Class

Documentación de las funciones miembro

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

Construye un mapa vinculable con el objeto padre parent. Utiliza este constructor en clases derivadas de QQmlPropertyMap.

El tipo de derived se utiliza para registrar el mapa de propiedades con el Sistema de Meta-Objetos, lo cual es necesario para asegurar que las propiedades de la clase derivada sean accesibles. Este tipo debe ser derivado de QQmlPropertyMap.

En el archivo C++:

class MyQmlPropertyMap : public QQmlPropertyMap
{
    Q_OBJECT
    QML_NAMED_ELEMENT(MyQmlPropertyMap)
public:
    explicit MyQmlPropertyMap(QObject *parent = nullptr)
        : QQmlPropertyMap(this, parent)
    {
        insert("name", "John Smith");
        insert("phone", "555-5555");
        insert("email", "john.smith@example.com");
    }

public slots:
    void updateEmail(const QString &newEmail)
    {
        insert("email", newEmail);
    }
};
    QQuickView view;
    view.setSource(QUrl("qrc:/main.qml"));
    view.show();

A continuación, en main.qml:

MyQmlPropertyMap
{
    id : owner
    Component.onCompleted: { owner.updateEmail("new.email@example.com") }
}
Text { text : owner.name + " " + owner.phone + " " + owner.email }

[override virtual noexcept] QQmlPropertyMap::~QQmlPropertyMap()

Destruye el mapa vinculable.

void QQmlPropertyMap::clear(const QString &key)

Borra el valor (si existe) asociado a key.

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

Devuelve true si el mapa contiene key.

Véase también size().

int QQmlPropertyMap::count() const

Igual que size().

[static] QQmlPropertyMap *QQmlPropertyMap::create(QObject *parent = nullptr)

Crea un mapa vinculable con el objeto padre parent.

[since 6.1] void QQmlPropertyMap::freeze()

Impide que se añadan más propiedades a este mapa de propiedades. Las propiedades existentes pueden modificarse o borrarse.

A su vez, se activa una caché interna para las propiedades existentes, lo que puede resultar en un acceso más rápido desde QML.

Esta función se introdujo en Qt 6.1.

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

Inserta el values en el QQmlPropertyMap.

Las claves que no existen se crean automáticamente.

Este método es sustancialmente más rápido que llamar a insert(key, value) muchas veces seguidas.

Esta función se introdujo en Qt 6.1.

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

Establece el valor asociado a key en value.

Si la clave no existe, se crea automáticamente.

bool QQmlPropertyMap::isEmpty() const

Devuelve true si el mapa no contiene claves; en caso contrario devuelve false.

Véase también size().

[invokable] QStringList QQmlPropertyMap::keys() const

Devuelve la lista de claves.

Las claves que hayan sido borradas seguirán apareciendo en esta lista, aunque sus valores asociados sean QVariantes inválidas.

int QQmlPropertyMap::size() const

Devuelve el número de claves del mapa.

Véase también isEmpty() y count().

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

Devuelve el nuevo valor que se almacenará para la clave key. Esta función se proporciona para interceptar actualizaciones de una propiedad desde QML, donde el valor proporcionado desde QML es input.

Anule esta función para manipular el valor de la propiedad a medida que se actualiza. Tenga en cuenta que esta función sólo se invoca cuando el valor se actualiza desde QML.

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

Devuelve el valor asociado a key.

Si no se ha establecido ningún valor para esta clave (o si se ha borrado el valor), se devuelve un QVariant no válido.

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

Esta señal se emite cada vez que se modifica uno de los valores del mapa. key es la clave correspondiente a value que se ha modificado.

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

Devuelve el valor asociado a la clave key como referencia modificable.

Si el mapa no contiene ningún elemento con la clave key, la función inserta un QVariant no válido en el mapa con la clave key, y devuelve una referencia al mismo.

Véase también insert() y value().

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

Igual que value().