Estilo

Los widgets integrados de Qt utilizan la clase ` QStyle ` para realizar prácticamente todo su dibujo. ` QStyle ` es una clase base abstracta que encapsula el aspecto y el comportamiento de una interfaz gráfica de usuario (GUI), y puede utilizarse para que los widgets tengan exactamente el mismo aspecto que los widgets nativos equivalentes o para darles un aspecto personalizado.

QStyle Los estilos ` windows ` y ` fusion ` están integrados en el módulo ` Qt Widgets `; los estilos de plataforma, como ` windows11 ` y ` macos`, se cargan como complementos. ` QStyleFactory ` enumera los estilos disponibles en tiempo de ejecución. Las aplicaciones también pueden proporcionar sus propios estilos, ya sea mediante enlaces o como complementos.

La mayoría de las funciones para dibujar elementos de estilo admiten cuatro argumentos:

  • un valor de enumeración que especifica qué elemento gráfico se va a dibujar
  • un objeto ` QStyleOption ` que especifica cómo y dónde renderizar ese elemento
  • un objeto ` QPainter ` que debe utilizarse para dibujar el elemento
  • un objeto ` QWidget ` sobre el que se realiza el dibujo (opcional)

El estilo obtiene toda la información que necesita para renderizar el elemento gráfico de la clase ` QStyleOption `. El widget se pasa como último argumento por si el estilo lo necesita para aplicar efectos especiales (como los botones animados predeterminados en macOS), pero no es obligatorio. De hecho, ` QStyle ` se puede utilizar para dibujar en cualquier dispositivo de pintura (no solo en widgets), en cuyo caso el argumento del widget es un puntero nulo.

Diagrama que muestra que QStylePainter hereda de QPainter

El sistema de dibujo también proporciona la clase ` QStylePainter `, que hereda de ` QPainter`. ` QStylePainter ` es una clase de conveniencia para dibujar elementos ` QStyle ` dentro de un widget, y amplía ` QPainter ` con un conjunto de funciones de dibujo de alto nivel implementadas sobre la API de ` QStyle`. La ventaja de utilizar ` QStylePainter ` es que las listas de parámetros se acortan considerablemente.

Icono utilizado en QtQIcon

La clase QIcon proporciona iconos escalables en diferentes modos y estados.

QIcon puede generar mapas de píxeles que reflejen el estado, el modo y el tamaño de un icono. Estos mapas de píxeles se generan a partir del conjunto de mapas de píxeles disponibles para el icono, y los Qt Widgets los utilizan para mostrar un icono que represente una acción concreta.

La representación de un objeto ` QIcon ` la gestiona la clase ` QIconEngine `. Cada icono tiene un motor de iconos correspondiente que se encarga de dibujar el icono con el tamaño, el modo y el estado solicitados.

Para obtener más información sobre el estilo y la apariencia de los widgets, consulta «Estilos y widgets sensibles al estilo » y «Enfoques de estilo para 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.