En esta página

ObjectRegistry QML Type

Este tipo se utiliza para registrar objetos con el fin de acceder a ellos posteriormente mediante una cadena clave. Más información...

Import Statement: import QtQml.DesignSupport
Since: Qt 6.12

Propiedades

Descripción detallada

El registro de objetos proporciona una referencia para los objetos en todo el motor QML. Cada objeto se registra con una clave de cadena, que se puede utilizar posteriormente para recuperar el objeto a través de uno de los siguientes tipos de referencia: ObjectRegistryRef y MultiObjectRegistryRef. También se proporcionan clases en C++ para acceder a los objetos registrados: QObjectRegistryRef y QMultiObjectRegistryRef.

Se puede utilizar la misma clave para registrar varios objetos. Un caso de uso típico es el registro de una lista o de un delegado «repeater».

El objeto registrado se elimina automáticamente del registro, ya sea al destruirse el objeto o al destruirse la instancia de ObjectRegistry. Al cambiar el objeto de destino o la clave, se elimina la combinación anterior del registro.

No registres la misma combinación de objeto y clave más de una vez. Solo se almacena un registro por combinación.

El registro puede realizarse mediante una propiedad adjunta en el objeto registrado o utilizando un objeto `ObjectRegistry` independiente con el objeto de destino y la clave:

// Registering with attached property
Item {
    id: itemToRegister
    ObjectRegistry.key: "MyItem"
}

// Registering with separate ObjectRegistry object
Item {
    id: itemToRegister
    ObjectRegistry {
        target: itemToRegister
        key: "MyItem"
    }
}

Véase también ObjectRegistryRef, MultiObjectRegistryRef, QObjectRegistryRef y QMultiObjectRegistryRef.

Documentación de propiedades

key : string

Esta propiedad especifica la clave del objeto registrado.

target : QtObject

Esta propiedad especifica el objeto de destino que se va a registrar.

Si el objeto de destino se destruye, esta propiedad se restablece a nulo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.