Qt Quick Archivo de configuración de Controls
Qt Quick Los controles admiten un archivo de configuración especial, qtquickcontrols2.conf, que está integrado en los recursos de una aplicación.
El archivo de configuración permite especificar el estilo preferido y determinados 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 principal son verde azulado y gris azulado, respectivamente. Sin embargo, si la aplicación se ejecuta con el estilo «Universal», el color de acento es rojo y se elige el tema adecuado en función de los colores del tema del sistema.
[Controls]
Style=Material
[Universal]
Theme=System
Accent=Red
[Material]
Theme=Light
Accent=Teal
Primary=BlueGreyEs posible especificar una ubicación personalizada para el archivo de configuración mediante la variable de entorno QT_QUICK_CONTROLS_CONF.
Sección «Controls»
En la sección « Controls » del archivo de configuración se pueden especificar los siguientes valores:
| 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 integrados o un estilo personalizado. |
FallbackStyle | Especifica el estilo que se utilizará para los controles que no estén implementados. El estilo debe ser uno de los estilos integrados. De forma predeterminada, se utiliza el estilo «Basic ». |
Sección «Imagine»
La siguiente tabla enumera los valores que se pueden utilizar para configurar el estilo «Imagine» en la sección « Imagine » del archivo de configuración:
| Variable | Descripción |
|---|---|
Path | Especifica 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: Para especificar una ruta relativa a un directorio local: 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 se pueden utilizar para configurar el estilo «Material» en la sección « Material » del archivo de configuración:
| Variable | Descripción |
|---|---|
Theme | Especifica el tema Material predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, « "Dark" ». |
Variant | Especifica la variante de Material. El diseño de Material 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 |
Accent | Especifica 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". |
Primary | Especifica 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". |
Foreground | Especifica 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". |
Background | Especifica el color de fondo predeterminado de Material. El valor puede ser cualquier 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» predeterminado. 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 cualquier 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 cualquier color, o uno de los colores predefinidos de Universal, por ejemplo, "Brown". |
Background | Especifica el color de fondo universal predeterminado. El valor puede ser cualquier color o uno de los colores universales predefinidos, por ejemplo, "Steel". |
Configuración de fuentes
El valor predeterminado de « font » se puede especificar en el subgrupo « Font » de la sección de cada estilo en el archivo de configuración:
[Basic]
Font\Family=Open Sans
Font\PixelSize=20Atributos de fuente admitidos:
| Variable | Descripción |
|---|---|
Family | La fuente predeterminada ( font family). |
PointSize | El point size. |
PixelSize | pixel size. |
StyleHint | style hint. Valores disponibles: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | El weight. Qt utiliza una escala de grosor que va desde 1 hasta 1000, compatible con OpenType. Un grosor de 1 será fino, mientras que 1000 será extremadamente negro. Grosores predefinidos disponibles: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | El parámetro « style ». Valores disponibles: « StyleNormal », « StyleItalic », « StyleOblique ». |
Configuración de la paleta
La configuración predeterminada de « palette » se puede ajustar para cada estilo mediante el subgrupo « Palette » del archivo de configuración. El subgrupo « Palette » se puede definir de dos formas diferentes:
[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121Consulta el tipo QML « Palette » para obtener más información.
Uso del archivo de configuración en un proyecto
Para que « Qt Quick Controls» pueda encontrar el archivo de configuración, este debe integrarse en los recursos de la aplicación mediante el sistema de recursos de Qt. A continuación se muestra un ejemplo de archivo « .qrc »:
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
<file>qtquickcontrols2.conf</file>
</qresource>
</RCC>Nota: Los controles« Qt Quick » utilizan un selector de archivos para cargar el archivo de configuración. Es posible proporcionar un archivo de configuración diferente para distintas plataformas y configuraciones regionales. Consulta la documentación de « QFileSelector » para obtener más detalles.
Por último, el archivo « .qrc » debe figurar 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 compilació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.