En esta página

Variables de entorno compatibles con Qt Quick Controls

Esta página contiene una lista de todas las variables de entorno compatibles con los controles de « Qt Quick ». Las variables de entorno están pensadas principalmente para fines de prueba, pero también pueden utilizarse para establecer valores predeterminados para todo el sistema.

VariableDescripción
QT_QUICK_CONTROLS_STYLEEspecifica el estilo predeterminado de los controles de «Qt Quick ». El valor puede ser uno de los estilos integrados, por ejemplo, "Material", o un estilo personalizado, como "MyStyle".
QT_QUICK_CONTROLS_FALLBACK_STYLEEspecifica un estilo alternativo para los estilos personalizados. El valor puede ser uno de los estilos integrados, por ejemplo, "Material",
QT_QUICK_CONTROLS_CONFEspecifica la ubicación del archivo de configuración de los controles «Qt Quick ». De forma predeterminada, el archivo de configuración se carga desde los recursos de la aplicación en ":/qtquickcontrols2.conf".
QT_QUICK_CONTROLS_HOVER_ENABLEDEspecifica si Qt Quick Controls utiliza hover effects. El valor puede establecerse en 0 o 1 para desactivar o activar los efectos al pasar el cursor, respectivamente.

Imagina variables de entorno específicasdel estilo:

VariableDescripción
QT_QUICK_CONTROLS_IMAGINE_PATHEspecifica la ruta al directorio que contiene los recursos del estilo Imagine. Si no se especifica, se utilizan los recursos integrados.

Por ejemplo, para especificar una ruta a un directorio almacenado en el sistema de recursos:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

Para especificar una ruta relativa a un directorio local:

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Nota: Debido a una limitación técnica, la ruta no debe llamarse «imagine» si es relativa al archivo qtquickcontrols2.conf.

QT_QUICK_CONTROLS_IMAGINE_SMOOTHEstablece el valor en 1 para habilitar el escalado fluido de las imágenes 9-patch. Esta variable de entorno se añadió en Qt 6.5.

Variables de entorno específicasdel estilo Material:

VariableDescripción
QT_QUICK_CONTROLS_MATERIAL_THEMEEspecifica el tema Material predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, "Dark".
QT_QUICK_CONTROLS_MATERIAL_VARIANTEspecifica la variante de Material. El Material Design tiene dos variantes: una variante normal diseñada para dispositivos táctiles y una variante «dense» para ordenadores de sobremesa. La variante «dense» utiliza tamaños más pequeños para los controles y sus fuentes.

El valor puede ser « "Normal" » o « "Dense" ».

QT_QUICK_CONTROLS_MATERIAL_ACCENTEspecifica el color de acento predeterminado de Material. El valor puede ser cualquier color, pero se recomienda utilizar uno de los colores predefinidos de Material, por ejemplo, "Teal".
QT_QUICK_CONTROLS_MATERIAL_PRIMARYEspecifica el color principal predeterminado de Material. El valor puede ser cualquier color, pero se recomienda utilizar uno de los colores predefinidos de Material, por ejemplo, "BlueGrey".
QT_QUICK_CONTROLS_MATERIAL_FOREGROUNDEspecifica el color de primer plano predeterminado de Material. El valor puede ser cualquier color o uno de los colores predefinidos de Material, por ejemplo, "Brown".
QT_QUICK_CONTROLS_MATERIAL_BACKGROUNDEspecifica el color de fondo predeterminado de Material. El valor puede ser cualquier color o uno de los colores predefinidos de Material, por ejemplo, "Grey".

Variables de entorno específicasdel estilo universal:

VariableDescripción
QT_QUICK_CONTROLS_UNIVERSAL_THEMEEspecifica el tema Universal predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, "Dark".
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTEspecifica el color de acento predeterminado de Universal. El valor puede ser cualquier color, pero se recomienda utilizar uno de los colores predefinidos de Universal, por ejemplo, "Violet".
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUNDEspecifica el color de primer plano predeterminado de Universal. El valor puede ser cualquier color o uno de los colores predefinidos de Universal, por ejemplo, "Brown".
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUNDEspecifica el color de fondo predeterminado de Universal. El valor puede ser cualquier color o uno de los colores predefinidos de Universal, por ejemplo, "Steel".

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