Tipo ausente
qmllint denomina esta categoría de advertencia « [missing-type] ».
No se puede deducir el tipo del alias
¿Qué ha pasado?
Una propiedad alias apunta a una propiedad con un tipo C++ cuya contraparte en QML no se ha encontrado. Esto puede deberse a la importación de un módulo QML que no declara sus dependencias QML con respecto a otros módulos.
Nota: Si estás importando módulos QML con dependencias externas, comprueba que estén realmente instalados y que sus módulos se encuentren en una ruta de importación.
La advertencia también podría indicar que el tipo de la propiedad a la que hace referencia el alias no tiene un equivalente en QML. Por ejemplo, es posible que al tipo de la propiedad a la que se hace referencia le falte la macro « QML_ELEMENT ». En este caso, consulta «Definición de tipos QML desde C++ » o «Descripción general: integración de QML y C++ ».
¿Por qué es un problema?
Las herramientas de QML no pueden encontrar el equivalente en QML del tipo de C++: el compilador no puede compilar este alias de propiedad a C++ y qmllint tampoco QML Language Server analizar este alias de propiedad.
Ejemplo
Supongamos que nuestro módulo QML tiene una clase C++ con una propiedad myProperty:
#include <QQuickItem>
#include <QtQml/qqmlregistration.h>
#include <QObject>
class MyCppObject : public QObject
{
Q_OBJECT
QML_ELEMENT
public:
MyCppObject(QObject *parent = nullptr)
: QObject(parent)
{}
Q_PROPERTY(QQuickItem *myProperty READ myProperty WRITE setMyProperty NOTIFY notifyMyProperty)
QQuickItem *myProperty() { return m_myProperty; }
void setMyProperty(QQuickItem *item) { emit notifyMyProperty(); m_myProperty = item; }
private:
QQuickItem *m_myProperty;
signals:
void notifyMyProperty();
};con el siguiente ` CMakeLists.txt`:
project(mymodule VERSION 0.1 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 6.5 REQUIRED COMPONENTS Quick)
qt_standard_project_setup(REQUIRES 6.5)
qt_add_executable(appmymodule
main.cpp
)
qt_add_qml_module(appmymodule
URI mymodule
VERSION 1.0
QML_FILES Main.qml HelloWorld.qml
SOURCES mycppobject.cpp mycppobject.h
)
target_link_libraries(appmymodule
PRIVATE Qt6::Quick
)Se ha declarado la dependencia de C++ Quick, de modo que esta clase se pueda compilar y se pueda encontrar la inclusión QQuickItem. Además, mymodule no tiene ninguna dependencia de QML con respecto a Qt Quick.
Ahora, intentemos utilizar myProperty en un alias en QML. El programa se ejecutará, pero las herramientas de QML, como el compilador, por ejemplo, mostrarán un mensaje de error por el uso de myProperty:
import mymodule
MyCppObject {
id: root
property alias myAlias: root.myProperty // not ok: Cannot deduce type of alias [missing-type]
}El motivo del mensaje de advertencia es que, en el código QML, no se reconocen el tipo QQuickItem de myProperty ni su equivalente en QML, Item, aunque tengas import QtQuick en tu archivo QML. Esto se debe a que un mismo tipo puede exponerse varias veces con diferentes atributos en distintos módulos: mymodule tiene que ser preciso en cuanto al tipo QML de myProperty.
Para solucionar esta advertencia, añade la dependencia en CMakeLists.txt:
qt_add_qml_module(mymodule
URI mymodule
...
# declarare QML dependency to QtQuick module
DEPENDENCIES QtQuick
...
)¡Ahora la advertencia debería haber desaparecido!
Véase también Declaración de dependencias de módulos.
No se ha encontrado ningún tipo para la propiedad
¿Qué ha pasado?
Se ha establecido un enlace en una propiedad cuyo tipo QML no se ha encontrado. Esto puede deberse a que un módulo QML no declara sus dependencias QML con respecto a otros módulos.
Nota: Si estás importando módulos QML con dependencias externas, comprueba que estén realmente instalados y que sus módulos se encuentren en una ruta de importación.
La advertencia también podría indicar que el tipo de la propiedad no tiene un equivalente en QML. Por ejemplo, es posible que al tipo de la propiedad le falte la macro « QML_ELEMENT ». En este caso, consulta «Definición de tipos QML desde C++ » o «Descripción general: integración de QML y C++ ».
¿Por qué es un problema?
Las herramientas de QML no pueden encontrar la contraparte en QML del tipo de C++: el compilador no puede compilar este enlace de propiedad en C++ y qmllint tampoco QML Language Server tampoco puede analizar este enlace de propiedad.
Ejemplo
Supongamos que nuestro módulo QML tiene una clase de C++ con dos propiedades, ` myProperty ` y ` myProperty2`:
#include <QQuickItem>
#include <QtQml/qqmlregistration.h>
#include <QObject>
class MyCppObject : public QObject
{
Q_OBJECT
QML_ELEMENT
public:
MyCppObject(QObject *parent = nullptr)
: QObject(parent)
{}
Q_PROPERTY(QQuickItem *myProperty READ myProperty WRITE setMyProperty NOTIFY notifyMyProperty)
QQuickItem *myProperty() { return m_myProperty; }
void setMyProperty(QQuickItem *item) { emit notifyMyProperty(); m_myProperty = item; }
Q_PROPERTY(QQuickItem *myProperty2 READ myProperty2 WRITE setMyProperty2 NOTIFY notifyMyProperty2)
QQuickItem *myProperty2() { return m_myProperty2; }
void setMyProperty2(QQuickItem *item) { emit notifyMyProperty2(); m_myProperty2 = item; }
private:
QQuickItem *m_myProperty;
QQuickItem *m_myProperty2;
signals:
void notifyMyProperty();
void notifyMyProperty2();
};con la siguiente declaración de CMakeLists.txt:
project(mymodule VERSION 0.1 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 6.5 REQUIRED COMPONENTS Quick)
qt_standard_project_setup(REQUIRES 6.5)
qt_add_executable(appmymodule
main.cpp
)
qt_add_qml_module(appmymodule
URI mymodule
VERSION 1.0
QML_FILES Main.qml HelloWorld.qml
SOURCES mycppobject.cpp mycppobject.h
)
target_link_libraries(appmymodule
PRIVATE Qt6::Quick
)Se ha declarado la dependencia de C++ Quick, de modo que esta clase se pueda compilar y se pueda encontrar la inclusión de QQuickItem. Además, mymodule no tiene ninguna dependencia de QML respecto a Qt Quick.
Ahora, intentemos vincular myProperty2 a myProperty mediante un alias en QML. El programa se ejecutará, pero las herramientas de QML, como el compilador, por ejemplo, mostrarán un mensaje de error sobre el uso de myProperty:
import mymodule
MyCppObject {
id: root
myProperty: myProperty2 // not ok: No type found for property "myProperty". [missing-type]
}El motivo del mensaje de advertencia es que, en el código QML, no se conocen el tipo QQuickItem de myProperty ni su equivalente en QML, Item: la dependencia QtQuick de mymodule no se ha declarado en CMakeLists.txt.
Para solucionar esta advertencia, añade la dependencia en el archivo CMakeLists.txt:
qt_add_qml_module(mymodule
URI mymodule
...
# declarare QML dependency to QtQuick module
DEPENDENCIES QtQuick
...
)¡Ahora, la advertencia debería haber desaparecido!
Véase también «Declaración de dependencias de módulos».
© 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.