Sin calificar
qmllint escribe esta categoría de advertencia como « [unqualified] ».
Acceso no calificado
¿Qué ha pasado?
Has accedido a un elemento padre sin su identificador (id).
¿Por qué es un error?
Esto dificulta la lectura del código y merma el rendimiento.
Ejemplo
import QtQuick
Item {
property int helloWorld
Item {
property int unqualifiedAccess: helloWorld + 1 // not ok: Unqualified access here.
}
}Para solucionar esta advertencia, haz referencia al objeto padre mediante su identificador. Tendrás que añadir primero un identificador si el objeto aún no tiene ninguno.
import QtQuick
Item {
id: root
property int helloWorld
Item {
property int unqualifiedAccess: root.helloWorld + 1 // ok: this access is qualified now!
}
}Ámbito de propiedad adjunta/agrupada desconocido
¿Qué ha pasado?
Has utilizado un tipo de propiedad adjunta o una propiedad agrupada que no se encuentra. Esto puede deberse a un error tipográfico o a que falte una dependencia del módulo QML.
Nota: Si estás importando módulos QML con dependencias externas, comprueba que estén realmente instalados y que se encuentren dentro de una ruta de importación.
¿Por qué es un problema?
Los componentes con ámbitos de propiedades adjuntas desconocidos o con propiedades agrupadas desconocidas no se crearán en tiempo de ejecución: en su lugar, serán nulos.
Ejemplo
Intentemos utilizar la propiedad adjunta (inexistente) Item o la propiedad agrupada (inexistente) grouped de Item:
import QtQuick
Item {
Item.helloAttached: 44 // not ok: unknown attached property scope Item. [unqualified]
grouped.helloGrouped: 44 // not ok: unknown grouped property scope grouped. [unqualified]
}De hecho, Item no tiene ningún tipo asociado ni ninguna propiedad agrupada llamada item. Para solucionar esta advertencia, elimina el tipo asociado y la propiedad agrupada.
Consulte «Propiedades adjuntas y controladores de señales adjuntos » para saber cómo utilizar las propiedades adjuntas, y «Propiedades agrupadas » para saber cómo utilizar las propiedades agrupadas.
No se ha encontrado ninguna señal que coincida con el controlador
¿Qué ha pasado?
Has utilizado un controlador de señal en una señal que no se encuentra. Esto puede deberse a un error tipográfico en el controlador de señal o a que falte una dependencia del módulo QML.
Nota: El nombre de un controlador de señal es on concatenado con el nombre de la señal en mayúsculas. Por ejemplo, onHelloWorld gestiona la señal helloWorld y on_helloWorld gestiona _helloWorld.
Nota: Si estás importando módulos QML con dependencias externas, comprueba que estén realmente instalados y que se encuentren dentro de una ruta de importación.
¿Por qué es esto un problema?
Los componentes con controladores de señal desconocidos no se crearán en tiempo de ejecución: en su lugar, serán nulos.
Ejemplo
Intentemos escribir un controlador de señal para la señal (inexistente) ` mySignal`:
import QtQuick
Item {
onMySignal: console.log("hello") // not ok: no matching signal found for handler "onMySignal" [unqualified]
}De hecho, este « Item » no tiene ninguna señal llamada « mySignal ». Para solucionar esta advertencia, elimina el controlador de señales o añade la señal que falta.
La definición implícita de controladores de señales en «Connections» está obsoleta
¿Qué ha pasado?
Has utilizado un controlador de señales en un tipo « Connections ».
¿Por qué no es recomendable?
Esta práctica está obsoleta.
Ejemplo
import QtQuick
Window {
id: root
property int myInt
Connections {
target: root
onMyIntChanged: console.log("new int", myInt)
}
}Para solucionar esta advertencia, sustituye el enlace del controlador de señales por una función:
import QtQuick
Window {
id: root
property int myInt
Connections {
target: root
function onMyIntChanged() { console.log("new int", myInt) }
}
}Véase también Convenciones de codificación de QML: Acceso sin calificar.
© 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.