Utilizar la función adecuada
qmllint denomina esta categoría de advertencia « [use-proper-function] ».
La propiedad es una propiedad variante: puede ser un método o no
¿Qué ha pasado?
Has utilizado una propiedad del tipo « var » como si fuera una función invocable.
¿Por qué es un error?
Esto afecta a la legibilidad del código; el motor de QML generará un error si la propiedad no contiene una función invocable, y las herramientas de QML no podrán aplicar optimizaciones específicas para métodos.
Ejemplo
import QtQuick
Item {
property var fun: () => console.log("Hello")
Component.onCompleted: { fun(); }
}Para solucionar esta advertencia, declara fun como una función para poder llamarla:
import QtQuick
Item {
function fun() {
console.log("Hello")
}
Component.onCompleted: { fun(); }
}La propiedad es una propiedad QJSValue: puede ser o no un método
¿Qué ha pasado?
Has utilizado una propiedad del tipo QJSValue como si fuera una función invocable.
Nota: Las propiedades del tipo QJSValue solo se pueden definir en C++.
¿Por qué es un error?
Es muy probable que la propiedad no estuviera pensada para ser llamada y provocará un error en el motor de QML en tiempo de ejecución.
Ejemplo
import QtQuick
Rectangle {
// Rectangle has a property gradient of the type QJSValue
Component.onCompleted: { console.log(gradient()); }
}Para solucionar esta advertencia, elimina la llamada a gradient:
import QtQuick
Item {
// Rectangle has a property gradient of the type QJSValue
Component.onCompleted: { console.log(gradient); }
}Como alternativa, considera sustituir la definición de la propiedad por un método Q_INVOKABLE normal o una slot si eres el autor de la propiedad. Esto solo es posible si no está previsto que la función se modifique nunca en QML. Si realmente necesitas almacenar una llamada de retorno, no hay nada que hacer.
La señal queda enmascarada por una propiedad
¿Qué ha pasado?
Has llamado a una señal que está enmascarada por una propiedad o has enmascarado una señal con una propiedad.
¿Por qué es un problema?
Es muy probable que quien realiza la llamada esperara llamar a una señal, y no a la propiedad que la enmascara. Esto podría provocar un error en el motor de QML en tiempo de ejecución.
Ejemplo
import QtQuick
Item {
component Base: Item {
signal helloSignal
}
Base {
property int helloSignal // shadows helloSignal inherited from Base
Component.onCompleted: { helloSignal(); }
}
}Para solucionar esta advertencia, cambia el nombre de la propiedad que enmascara:
import QtQuick
Item {
component Base: Item {
signal helloSignal
}
Base {
property int helloSignal2 // does not shadow anymore
Component.onCompleted: { helloSignal(); }
}
}El método está enmascarado por una propiedad
Véase {La señal está enmascarada por una propiedad}.
La ranura está enmascarada por una propiedad
Véase {La señal está enmascarada por una propiedad}.
La propiedad no es un método
¿Qué ha pasado?
Has utilizado una propiedad de un tipo distinto de var o QJSValue como si fuera una función invocable.
¿Por qué es un error?
La propiedad no se puede invocar y provocará un error en el motor de QML en tiempo de ejecución.
Ejemplo
Para solucionar esta advertencia, elimina la llamada o convierte « hello » en una función:
import QtQuick
Item {
property int hello
Component.onCompleted: { console.log(hello); }
// alternative:
function helloAlternative() { ... }
Component.onCompleted: { console.log(helloAlternative()); }
}© 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.