En esta página

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=BlueGrey

Es 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:

VariableDescripción
StyleEspecifica 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.
FallbackStyleEspecifica 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:

VariableDescripción
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:

[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 qtquickcontrols2.conf.

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:

VariableDescripción
ThemeEspecifica el tema Material predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, « "Dark" ».
VariantEspecifica 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 "Normal" o "Dense".

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

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:

VariableDescripción
ThemeEspecifica el tema «Universal» predeterminado. El valor puede ser uno de los temas disponibles, por ejemplo, "Dark".
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".
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".
BackgroundEspecifica 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=20

Atributos de fuente admitidos:

VariableDescripción
FamilyLa fuente predeterminada ( font family).
PointSizeEl point size.
PixelSizepixel size.
StyleHintstyle hint. Valores disponibles: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive.
WeightEl 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).
StyleEl 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=#212121

Consulta 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

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