Qt Quick Controls Fichero de configuración
Qt Quick Controls soportan un archivo de configuración especial, qtquickcontrols2.conf, que se incorpora a los recursos de una aplicación.
El archivo de configuración puede especificar el estilo preferido y ciertos atributos específicos del estilo. El siguiente ejemplo especifica que el estilo preferido es el estilo Material. Además, cuando la aplicación se ejecuta con el estilo Material, su tema es claro y los colores de acento y primario son el verde azulado y el gris azulado, respectivamente. Sin embargo, si la aplicación se ejecuta con el estilo Universal, el color de acento es rojo y el tema apropiado se elige basándose en los colores del tema del sistema.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
Es posible especificar una ubicación personalizada para el archivo de configuración con la variable de entorno QT_QUICK_CONTROLS_CONF.
Sección Controles
Los siguientes valores pueden especificarse en una sección Controls del archivo de configuración:
| Variable | Descripción |
|---|---|
Style | Especifica el estilo con el que se ejecutará la aplicación. El valor puede ser el nombre de uno de los estilos incorporados o un estilo personalizado. |
FallbackStyle | Especifica el estilo a utilizar para los controles que no están implementados. El estilo debe ser uno de los estilos incorporados. Por defecto, se utiliza el estilo Básico. |
Sección Imagine
La siguiente tabla enumera los valores que pueden utilizarse para configurar el estilo Imagine en una sección Imagine del archivo de configuración:
| Variable | Descripción |
|---|---|
Path | Especifica la ruta al directorio que contiene los activos del estilo Imagine. Si no se especifica, se utilizan los activos incorporados. Por ejemplo, para especificar una ruta a un directorio almacenado en el sistema de recursos: [Imagine] Path=:/imagine-assets Para especificar una ruta relativa a un directorio local: [Imagine] Path=imagine-assets Nota: Debido a una limitación técnica, la ruta no debe llamarse "imagine" si es relativa al archivo |
Sección Material
La siguiente tabla enumera los valores que pueden utilizarse para configurar el estilo Material en una sección Material del archivo de configuración:
| Variable | Descripción |
|---|---|
Theme | Especifica el tema Material por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark". |
Variant | Especifica la variante de Material. El Material Design tiene dos variantes: una variante normal diseñada para dispositivos táctiles, y una variante densa para escritorio. La variante densa utiliza tamaños más pequeños para los controles y sus fuentes. El valor puede ser |
Accent | Especifica el color de acento Material por defecto. El valor puede ser cualquiera color, pero se recomienda utilizar uno de los colores predefinidos de Material, por ejemplo "Teal". |
Primary | Especifica el color primario por defecto del Material. El valor puede ser cualquiera color, pero se recomienda utilizar uno de los colores predefinidos de Material, por ejemplo "BlueGrey". |
Foreground | Especifica el color de primer plano por defecto del Material. El valor puede ser cualquiera color, o uno de los colores predefinidos de Material, por ejemplo "Brown". |
Background | Especifica el color de fondo por defecto del Material. El valor puede ser cualquiera color, o uno de los colores predefinidos de Material, por ejemplo "Grey". |
Sección universal
La siguiente tabla enumera los valores que se pueden utilizar para configurar el estilo Universal en una sección Universal del archivo de configuración:
| Variable | Descripción |
|---|---|
Theme | Especifica el tema Universal por defecto. El valor puede ser uno de los temas disponibles, por ejemplo "Dark". |
Accent | Especifica el color de acento predeterminado de Universal. El valor puede ser cualquiera color, pero se recomienda utilizar uno de los colores predefinidos de Universal, por ejemplo "Violet". |
Foreground | Especifica el color de primer plano predeterminado de Universal. El valor puede ser cualquiera color, o uno de los colores Universal predefinidos, por ejemplo "Brown". |
Background | Especifica el color de fondo predeterminado de Universal. El valor puede ser cualquier color, o uno de los colores Universal predefinidos, por ejemplo "Steel". |
Configuración de fuentes
La fuente predeterminada font puede especificarse en un subgrupo Font en la sección de cada estilo en el archivo de configuración:
[Basic] Font\Family=Open Sans Font\PixelSize=20
Atributos de fuente admitidos:
| Variable | Descripción |
|---|---|
Family | El font family. |
PointSize | El point size. |
PixelSize | pixel size. |
StyleHint | El style hint. Valores disponibles: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | El weight. Qt utiliza una escala de ponderación de 1 a 1000 compatible con OpenType. Un peso de 1 será fino, mientras que 1000 será extremadamente negro. Pesos predefinidos disponibles: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | Los valores disponibles son style: StyleNormal, StyleItalic, StyleOblique. |
Configuración de la paleta
El valor por defecto palette puede configurarse para cada estilo utilizando el subgrupo Palette del archivo de configuración. El subgrupo Palette puede definirse de dos formas alternativas:
[Fusion] Palette\Window=#dedede Palette\WindowText=#212121
Consulte Palette tipo QML para obtener más información.
Utilización del archivo de configuración en un proyecto
Para que Qt Quick Controls pueda encontrar el archivo de configuración, debe incorporarse a los recursos de la aplicación utilizando el sistema de recursos de Qt. Aquí hay un ejemplo de archivo .qrc:
<!DOCTYPE RCC><RCC version="1.0"> <qresource prefix="/"> <file>qtquickcontrols2.conf</file> </qresource> </RCC>
Nota: Qt Quick Controls utiliza un selector de archivos para cargar el archivo de configuración. Es posible proporcionar un archivo de configuración diferente para diferentes plataformas y locales. Consulte la documentación de QFileSelector para más detalles.
Por último, el archivo .qrc debe aparecer en el archivo de compilación de la aplicación. Por ejemplo
set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
application.qrc
main.cpp
...
)RESOURCES = application.qrc ...
Véase también: Integración del sistema de construcción
Información relacionada
© 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.
