Estilo Qt Quick Controls

Estilos disponibles

Qt Quick Controls viene con una selección de estilos.

Estilo básico

El Basic Style es un estilo sencillo y ligero que ofrece el máximo rendimiento para Qt Quick Controls.

Estilo Fusión

El estilo Fusion es un estilo independiente de la plataforma que ofrece un aspecto orientado al escritorio para Qt Quick Controls.

Estilo Imagine

El estilo Imagine se basa en activos de imagen. El estilo viene con un conjunto de imágenes por defecto que puede cambiarse fácilmente proporcionando un directorio con imágenes utilizando una convención de nomenclatura predefinida.

Estilo macOS

El estilo macOS es un estilo de aspecto nativo para macOS.

Estilo iOS

El estilo iOS es un estilo de aspecto nativo para iOS basado en activos de imagen.

Estilo Material

El estilo Material ofrece un diseño atractivo basado en las directrices de diseño Material de Google, pero requiere más recursos del sistema que el estilo Básico.

Estilo Universal

El estilo Universal ofrece un diseño atractivo basado en las directrices de diseño Universal de Microsoft, pero requiere más recursos del sistema que el estilo Básico.

Estilo Windows

El estilo Windows es un estilo de aspecto nativo para Windows.

Estilo FluentWinUI3

El estilo FluentWinUI3 es un estilo moderno de aspecto nativo diseñado para plataformas con Windows 11 o superior, que sigue las directrices de diseño de Fluent UI y WinUI 3. FluentWinUI3 se puede ejecutar en todas las plataformas compatibles.

Uso de estilos en Qt Quick Controls

Estilos por defecto

Si no se establece explícitamente ningún estilo, se utilizará un estilo predeterminado. El estilo que se utiliza depende del sistema operativo:

• Android: Estilo Material
• iOS: Estilo iOS
• Linux: Estilo Fusion
• macOS: Estilo macOS
• Windows: Estilo Windows

Para todos los demás sistemas operativos, se utiliza el estilo básico.

Selección de estilo en tiempo de compilación

La selección de estilo en tiempo de compilación es una forma de especificar un estilo a utilizar importándolo explícitamente en QML. Por ejemplo, para importar el estilo Material:

// The style must be imported before any other QtQuick.Controls imports
// in order for run-time style selection API like QQuickStyle::name() to
// work.
import QtQuick.Controls.Material

ApplicationWindow {
    // ...
}

Observe que QtQuick.Controls (responsable de la selección de estilos en tiempo de ejecución) no se importa. El estilo de reserva se especifica mediante el qmldir del estilo:

module QtQuick.Controls.Material
# ...
import QtQuick.Controls.Basic auto

La ventaja de la selección de estilo en tiempo de compilación es que el compilador QML sabe qué estilo específico está en uso y puede generar código C++ para los enlaces.

Otra ventaja es que no se utiliza el plugin QtQuick.Controls y, por tanto, no es necesario desplegarlo con la aplicación.

Las importaciones explícitas también son necesarias si tu aplicación se construye estáticamente.

Una desventaja de la selección de estilo en tiempo de compilación es que un ejecutable no puede soportar múltiples estilos, ya que cada estilo requiere el suyo propio.

Consulte Mezclar selección de estilos para obtener información sobre cómo mezclar la selección de estilos en tiempo de compilación y en tiempo de ejecución.

Selección de estilos en tiempo de ejecución

La selección de estilo en tiempo de ejecución es una forma de especificar un estilo a utilizar importando QtQuick.Controls:

import QtQuick.Controls

El complemento QtQuick.Controls importará el estilo establecido en tiempo de ejecución mediante uno de los siguientes métodos:

• QQuickStyle::setStyle()
• El argumento de línea de comandos -style
• La variable de entorno QT_QUICK_CONTROLS_STYLE
• El archivo de configuración qtquickcontrols2.conf

La prioridad de estos enfoques sigue el orden en que se enumeran, de mayor a menor. Es decir, el uso de QQuickStyle para establecer el estilo siempre tendrá prioridad sobre el uso del argumento de la línea de comandos, por ejemplo.

Del mismo modo, el estilo fallback puede establecerse mediante uno de los siguientes métodos:

• QQuickStyle::setFallbackStyle()
• La variable de entorno QT_QUICK_CONTROLS_FALLBACK_STYLE
• El archivo de configuración qtquickcontrols2.conf

La ventaja de la selección de estilo en tiempo de ejecución es que un único binario de aplicación puede soportar múltiples estilos, lo que significa que el usuario final puede elegir con qué estilo ejecutar la aplicación.

Una desventaja de este enfoque es que el compilador QML no puede saber qué estilo específico está en uso y, por lo tanto, no puede generar código C++ para los enlaces en propiedades de tipos Qt Quick Controls. Esto no afecta a la capacidad del compilador QML para generar código C++ para enlaces a tipos de otros módulos.

Consulta Mixing Style Selection para obtener información sobre cómo combinar la selección de estilos en tiempo de ejecución y en tiempo de compilación.

Combinación de selección de estilos

Se recomienda utilizar únicamente la selección de estilos en tiempo de compilación o en tiempo de ejecución en la aplicación. Sin embargo, si su aplicación carga código QML de terceros, por ejemplo, puede que no sea posible controlar qué importaciones se utilizan. Si combina ambos métodos, tenga en cuenta las siguientes limitaciones:

• La selección de estilo en tiempo de compilación anula la selección de estilo en tiempo de ejecución.
• El estilo que desee utilizar siempre debe importarse explícitamente antes de importar cualquier otro Control. Si no lo hace, la tematización (como fuentes y paletas) no se comportará como se espera. El primer estilo importado explícitamente es también lo que informará QQuickStyle::name().
• El último estilo importado explícitamente es el que se utilizará realmente. Por ejemplo, si importa QtQuick.Controls primero y luego QtQuick.Controls.Material, el Button.qml del estilo Material se utilizará cuando se cree un Botón. Debido al punto anterior sobre la tematización, es por esta razón que nunca debe importar explícitamente dos estilos diferentes en la misma aplicación.
• Si tiene intención de utilizar la selección de estilo en tiempo de compilación pero carga código que importa QtQuick.Controls, tenga en cuenta que llamar a QQuickStyle::name() antes de que se haya importado explícitamente un estilo hará que se informe del valor predeterminado de la plataforma. Si no puede evitar esto, establezca el estilo para que coincida con el de compilación de antemano a través de QQuickStyle::setStyle() o alguna de las otras formas listadas en Selección de Estilo en Tiempo de Ejecución.

Uso de QQuickStyle en C

QQuickStyle proporciona la API de C++ para configurar un estilo específico. El siguiente ejemplo ejecuta una aplicación Qt Quick Controls con el estilo Material:

QQuickStyle::setStyle("Material");

Véase la descripción detallada de QQuickStyle para más detalles.

Argumento de línea de comandos

Pasar un argumento de línea de comandos -style es la forma más conveniente de probar diferentes estilos. Tiene prioridad sobre los demás métodos enumerados a continuación. El siguiente ejemplo ejecuta una aplicación Qt Quick Controls con el estilo Material:

./app -style Material

Variable de entorno

La variable de entorno QT_QUICK_CONTROLS_STYLE puede utilizarse para establecer una preferencia de estilo para todo el sistema. Tiene prioridad sobre el archivo de configuración mencionado a continuación. El siguiente ejemplo ejecuta una aplicación Qt Quick Controls con el estilo Universal:

QT_QUICK_CONTROLS_STYLE=Universal ./app

Consulte Variables de entorno compatibles en Qt Quick Controls para ver la lista completa de variables de entorno compatibles.

Archivo de configuración

Qt Quick Controls admite 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 (puede ser anulado por cualquiera de los métodos descritos anteriormente) y ciertos atributos específicos del estilo. El siguiente ejemplo especifica que el estilo preferido es el estilo Material.

[Controls]
Style=Material

Consulte Qt Quick Controls Configuration File para obtener más información sobre el archivo de configuración.

Información relacionada

• Estilo básico
• Estilo Fusion
• Estilo Imagine
• Estilo Material
• Estilo Universal
• Estilo FluentWinUI3
• Personalización de Qt Quick Controls
• Uso de selectores de archivos con Qt Quick Controls
• Desplegando Aplicaciones Qt Quick Controls
• Qt Quick Controls Archivo de Configuración
• Variables de entorno soportadas en Qt Quick Controls