En esta página

Propiedades de contexto

qmllint escribe esta categoría de advertencia como « [context-properties] ».

Se ha detectado un posible acceso a una propiedad de contexto

¿Qué ha ocurrido?

Se ha detectado un posible acceso a una propiedad de contexto.

¿Por qué es un problema?

Al utilizar propiedades de contexto en tu código QML, creas una dependencia de tu código QML respecto al contexto específico que tienes en mente al escribirlo. Esto limita la reutilización de tu código, ya que el contexto puede ser diferente en otros lugares donde se pueda utilizar. Además, la dependencia no está declarada. Nunca importas el contexto ni indicas de ningún otro modo lo que esperas. Por lo tanto, cualquiera que intente reutilizar tu código tendrá dificultades para averiguar si el lugar donde se reutiliza cuenta con un contexto suficiente para tu código.

Las herramientas de QML no pueden utilizar la propiedad «context»: el compilador no puede compilar este archivo a C++ y ni qmllint ni QML Language Server proporcionar advertencias útiles sobre ese archivo.

Ejemplo

// main.cpp
int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);
    QQuickView view;
    view.rootContext()
        ->setContextProperty("myProperty", QDateTime::currentDateTime());
    view.loadFromModule("MyModule", "Main");
    view.show();
    app.exec();
}
// Main.qml
import QtQuick

Item {
    Component.onCompleted: console.log(myProperty)
}

Para solucionar esta advertencia, puedes:

  • Hacer que la propiedad sea obligatoria.
  • Utilizar un singleton.
  • Añadir una entrada a .contextProperties.ini.

Uso de una propiedad obligatoria

Utiliza propiedades obligatorias para las propiedades de contexto que tienen valores diferentes en distintos componentes. Para solucionar esta advertencia con una propiedad obligatoria, utiliza uno de los métodos de setInitialProperties en lugar de setContextProperty:

Define también la propiedad necesaria en Main.qml.

// main.cpp
int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);
    QQuickView view;
    view.setInitialProperties( { {"myProperty", QDateTime::currentDateTime()}  } );
    view.loadFromModule("MyModule", "Main");
    view.show();
    app.exec();
}
// Main.qml
import QtQuick

Item {
    required property date myProperty
    Component.onCompleted: console.log(myProperty)
}

Véase también «Exposición del estado desde C++ a QML».

Uso de un singleton

Utiliza singletons para las propiedades de contexto que tengan el mismo valor en todos los componentes. Para solucionar esta advertencia con un singleton, elimina la llamada a setContextProperty, define un singleton y sustituye el uso de la propiedad de contexto por la propiedad del singleton.

// mysingleton.h
class MySingleton : public QObject {
    Q_OBJECT
    QML_SINGLETON
    QML_ELEMENT
    Q_PROPERTY(QDateTime myProperty MEMBER m_myProperty NOTIFY myPropertyChanged FINAL)

    QDateTime m_myProperty = QDateTime::currentDateTime();
signals:
    void myPropertyChanged();
};
// main.cpp
int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);
    QQuickView view;
    view.loadFromModule("MyModule", "Main");
    view.show();
    app.exec();
}
// Main.qml
import QtQuick

Item {
    Component.onCompleted: console.log(MySingleton.myProperty)
}

Véase también «Exposición del estado desde C++ a QML».

Añadir una entrada al archivo .contextProperties.ini

Si no puedes sustituir la propiedad de contexto, crea un archivo .contextProperties.ini en el directorio de fuentes de tu proyecto (si aún no existe) y escribe el siguiente contenido:

[General]
disableUnqualifiedAccess = "myProperty"
warnOnUsage = "myProperty"
disableHeuristic = false

Para silenciar esta advertencia si el archivo « .contextProperties.ini » ya existe, añade el nombre de la propiedad de contexto a las listas ya existentes:

[General]
disableUnqualifiedAccess = "someOtherProperty,myProperty"
warnOnUsage = "someOtherProperty,myProperty"
disableHeuristic = false

Consulta también «Configuración de propiedades de contexto » para obtener más información sobre el formato de .contextProperties.ini.

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