En esta página

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.