En esta página

Mayúsculas y minúsculas de la clave de la enumeración

qmllint escribe esta categoría de advertencia como « [enum-key-case] ».

La clave de la enumeración comienza con una letra minúscula

¿Qué ha pasado?

Una enumeración contiene una clave que empieza por una letra minúscula.

¿Por qué es un problema?

Puede generar ambigüedad al realizar búsquedas. Las claves de las enumeraciones deben comenzar con una letra mayúscula para distinguirlas de las propiedades de los singletons y los objetos adjuntos. No seguir esta convención puede dar lugar a resultados inesperados.

Ejemplo

// Properties.qml
import QtQuick

Item {
    enum Color { red, green, blue }
}
// Main.qml
import QtQuick

Item {
    // This lookup could be interpreted as a property lookup on a Singleton or attached object.
    property int i: Properties.green
}

Para solucionar esta advertencia, cambia el nombre de la clave para que empiece por una letra mayúscula.

// Properties.qml
import QtQuick

Item {
    enum Color { Red, Green, Blue }
}
// Main.qml
import QtQuick

Item {
    // No ambiguity for the user or the QML engine, this is an enum lookup.
    property int i: Properties.Green
}

© 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.