Estilos y widgets sensibles al estilo
Los estilos (clases que heredan de ` QStyle`) se encargan del dibujo en nombre de los widgets y encapsulan la apariencia de una interfaz gráfica de usuario. ` QStyle ` es una clase base abstracta. Los widgets integrados de Qt los utilizan para casi todo su dibujo, por lo que tienen exactamente el mismo aspecto que los widgets nativos equivalentes.
Qt incluye una selección de estilos integrados. Los estilos ` windows ` y ` fusion ` forman parte del módulo ` Qt Widgets `. Los estilos de plataforma, como ` windows11 ` en Windows y ` macos ` en macOS, son complementos que solo están disponibles en su respectiva plataforma. ` QStyleFactory ` enumera los estilos disponibles en tiempo de ejecución y los crea por su nombre. ` QApplication::setStyle()` establece un estilo como el estilo de la aplicación, y los usuarios pueden seleccionar un estilo con la opción de línea de comandos ` -style `.
Una implementación de « QStyle » es la forma de dotar a una aplicación de producción de su propio aspecto. StyleKit proporciona una, QStyleKitStyle, que lee una descripción QML del diseño. Para saber cuándo utilizar un estilo, StyleKit o una hoja de estilo, consulta «Enfoques de estilo» en Qt Widgets.
Personalización de un estilo
Para modificar determinados aspectos de un estilo existente, hereda de QProxyStyle y reimplementa las funciones virtuales que dibujan o miden los elementos que deseas modificar. Un estilo proxy envuelve otro estilo y le reenvía todo aquello que no reimplemente.
Puede especificar el estilo base de forma explícita o dejarlo sin especificar. Un estilo base explícito le ofrece un control total y resulta adecuado para personalizaciones que dependen del comportamiento de un estilo concreto. Sin un estilo base, el proxy envuelve el estilo de la aplicación, por lo que su personalización se aplica sobre lo que proporcione la plataforma.
The QStyle class documentation muestra un estilo proxy que sustituye las flechas de un cuadro giratorio.
Implementación de un estilo
QCommonStyle proporciona una base práctica para implementaciones completas de estilos. Implementa el comportamiento que comparten todos los estilos de Qt, como la disposición de los subelementos y los cálculos de tamaño, y te deja a ti la tarea de dibujarlo. Hered QCommonStyle reimplementa las funciones de dibujo, junto con las métricas de píxeles, los rectángulos de los subelementos y las sugerencias de estilo que difieran de los valores predeterminados comunes. Los estilos integrados de Qt XML no forman parte de la API pública y no pueden servir como clases base; en su lugar, envuélvelos con QProxyStyle.
Implementar un estilo completo es una tarea compleja. Las páginas siguientes describen cómo funciona la API de estilos, trazan el proceso de dibujo de un widget desde su evento de pintura hasta el estilo y enumeran los elementos, estados y opciones que utiliza cada widget:
- «Cómo dibuja un estilo un widget» explica los elementos de estilo, los subelementos, las métricas de píxeles, las sugerencias de estilo, las opciones de estilo, las funciones « QStyle » y la paleta.
- «Creación de widgets sensibles al estilo» muestra cómo un widget personalizado se dibuja según el estilo actual, de modo que se vea correctamente en cualquier estilo.
- «Aplicación de estilos a una casilla de selección: un tutorial» sigueel recorrido de un « QCheckBox » desde su evento «paint» hasta « QCommonStyle » y termina con un indicador personalizado.
- La «Referencia de estilos de widgets» enumera, para cada widget, los elementos de estilo que dibuja, los indicadores de estado que establece y los miembros de su opción de estilo.
Los elementos que dibujan los widgets son los mismos en todos los estilos, por lo que también puedes utilizar la referencia cuando escribas un widget sensible al estilo o un delegado.
Clases para el estilo de los widgets
Utiliza estas clases para personalizar la apariencia de una aplicación.
Colores basados en valores RGB, HSV o CMYK | |
Abstracción del espacio de color | |
Transformación entre espacios de color | |
Encapsula el aspecto y la sensación comunes de una interfaz gráfica de usuario | |
Cursor del ratón con una forma arbitraria | |
Especifica una consulta sobre la fuente utilizada para dibujar texto | |
Información sobre las fuentes disponibles en el sistema de ventanas subyacente | |
Información general sobre las fuentes | |
Representa un anclaje entre dos elementos en un QGraphicsAnchorLayout | |
Diseño en el que se pueden anclar widgets entre sí en Graphics View | |
Contiene grupos de colores para cada estado del widget | |
Clase base abstracta que encapsula el aspecto y el comportamiento de una interfaz gráfica de usuario | |
Crea objetos QStyle | |
Sugerencias de estilo que devuelven más que tipos de datos básicos | |
Sugerencias de estilo que devuelven una QRegion | |
Sugerencias de estilo que devuelven un QVariant | |
Aplica un estilo de Qt Labs StyleKit a Qt Widgets | |
Almacena los parámetros utilizados por las funciones de QStyle | |
Clase de conveniencia para dibujar elementos QStyle dentro de un widget |
Véase también QStyle, QProxyStyle, QCommonStyle, QStylePainter, QStyleOption y «Enfoques de estilo» en Qt Widgets.
© 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.