En esta página

Tipos de objeto de QML

Un tipo de objeto QML es un tipo a partir del cual se puede instanciar un objeto QML.

En términos sintácticos, un tipo de objeto QML es aquel que se puede utilizar para declarar un objeto especificando el nombre del tipo seguido de un par de llaves que engloban los atributos de dicho objeto. Esto difiere de los tipos de valor, que no se pueden utilizar de la misma manera. Por ejemplo, ` Rectangle ` es un tipo de objeto QML: se puede utilizar para crear objetos de tipo ` Rectangle `. Esto no se puede hacer con tipos primitivos como ` int ` y ` bool`, que se utilizan para almacenar tipos de datos simples en lugar de objetos.

Los tipos de objeto QML personalizados pueden definirse creando un archivo .qml que defina el tipo, tal y como se explica en «Documentos como definiciones de tipos de objeto QML», o bien definiendo un tipo QML desde C++ y registrando el tipo en el motor QML, tal y como se explica en «Definición de tipos QML desde C++». Ten en cuenta que, en ambos casos, el nombre del tipo debe comenzar con una letra mayúscula para poder declararse como tipo de objeto QML en un archivo QML.

Para obtener más información sobre C++ y los diferentes métodos de integración con QML, consulta la página de resumen sobre la integración de C++ y QML.

Existen dos tipos de objeto integrados que pueden utilizarse sin necesidad de importar ningún otro módulo: ` QtObject ` es el tipo base de todos los tipos de objeto. ` Component ` puede utilizarse para definir nuevos tipos de objeto de forma inline en documentos QML.

Definición de tipos de objeto desde QML

Definición de tipos de objeto a través de documentos QML

Los creadores de complementos y los desarrolladores de aplicaciones pueden proporcionar tipos definidos como documentos QML. Un documento QML, cuando es visible para el sistema de importación de QML, define un tipo identificado por el nombre del archivo sin las extensiones.

Por lo tanto, si existe un documento QML llamado «MyButton.qml», este proporciona la definición del tipo «MyButton», que puede utilizarse en una aplicación QML.

Consulte la documentación sobre documentos QML para obtener información sobre cómo definir un documento QML y la sintaxis del lenguaje QML. Una vez que se haya familiarizado con el lenguaje QML y con cómo definir documentos QML, consulte la documentación que explica cómo definir y utilizar sus propios tipos QML reutilizables en documentos QML.

Consulta Definición de tipos de objetos mediante documentos QML para obtener más información.

Definición de tipos anónimos con «Component»

Otro método para crear tipos de objeto desde QML consiste en utilizar el tipo ` Component `. Esto permite definir un tipo directamente dentro de un documento QML, en lugar de utilizar un documento independiente en un archivo ` .qml `.

Item {
    id: root
    width: 500; height: 500

    Component {
        id: myComponent
        Rectangle { width: 100; height: 100; color: "red" }
    }

    Component.onCompleted: {
        myComponent.createObject(root)
        myComponent.createObject(root, {"x": 200})
    }
}

En este caso, el objeto ` myComponent ` define esencialmente un tipo anónimo que puede instanciarse mediante ` Component::createObject ` para crear objetos de este tipo anónimo.

Los componentes en línea comparten todas las características de los componentes normales de nivel superior y utilizan la misma lista « import » que el documento QML que los contiene.

Ten en cuenta que cada declaración del objeto ` Component ` crea su propio ámbito de componente. Cualquier valor de `id` utilizado y al que se haga referencia desde el interior de una declaración del objeto ` Component ` debe ser único dentro de ese ámbito, pero no es necesario que sea único dentro del documento en el que se declara el componente en línea. Por lo tanto, el Rectangle declarado en la declaración del objeto myComponent podría tener un id de root sin entrar en conflicto con el root declarado para el objeto Item en el mismo documento, ya que estos dos valores de id se declaran dentro de ámbitos de componente diferentes.

Consulte «Ámbito y resolución de nombres » para obtener más detalles.

Definición de tipos de objetos desde C++

Los creadores de complementos y los desarrolladores de aplicaciones en C++ pueden registrar tipos definidos en C++ a través de la API proporcionada por el módulo Qt Qml. Existen varias funciones de registro, cada una de las cuales permite satisfacer diferentes casos de uso. Para obtener más información sobre estas funciones de registro y los detalles específicos de cómo exponer tipos C++ personalizados a QML, consulta la documentación sobre «Definición de tipos QML desde C++».

El sistema de tipos de QML se basa en que las importaciones, los complementos y las extensiones estén instalados en una ruta de importación conocida. Los complementos pueden ser proporcionados por desarrolladores externos y reutilizados por los desarrolladores de aplicaciones cliente. Consulte la documentación sobre módulos QML para obtener más información sobre cómo crear e implementar un módulo de extensión QML.

© 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.