En esta página

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:

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.

QColor

Colores basados en valores RGB, HSV o CMYK

QColorSpace

Abstracción del espacio de color

QColorTransform

Transformación entre espacios de color

QCommonStyle

Encapsula el aspecto y la sensación comunes de una interfaz gráfica de usuario

QCursor

Cursor del ratón con una forma arbitraria

QFont

Especifica una consulta sobre la fuente utilizada para dibujar texto

QFontDatabase

Información sobre las fuentes disponibles en el sistema de ventanas subyacente

QFontInfo

Información general sobre las fuentes

QGraphicsAnchor

Representa un anclaje entre dos elementos en un QGraphicsAnchorLayout

QGraphicsAnchorLayout

Diseño en el que se pueden anclar widgets entre sí en Graphics View

QPalette

Contiene grupos de colores para cada estado del widget

QStyle

Clase base abstracta que encapsula el aspecto y el comportamiento de una interfaz gráfica de usuario

QStyleFactory

Crea objetos QStyle

QStyleHintReturn

Sugerencias de estilo que devuelven más que tipos de datos básicos

QStyleHintReturnMask

Sugerencias de estilo que devuelven una QRegion

QStyleHintReturnVariant

Sugerencias de estilo que devuelven un QVariant

QStyleKitStyle

Aplica un estilo de Qt Labs StyleKit a Qt Widgets

QStyleOption

Almacena los parámetros utilizados por las funciones de QStyle

QStylePainter

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.