En esta página

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

import QtQuick

Item {
    property int hello
    Component.onCompleted: { console.log(hello()); }
}

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.