En esta página

Referencia de estilos de widgets

Esta referencia describe cómo los widgets de Qt utilizan el estilo. Úsala cuando implementes un estilo, para ver qué elementos debes dibujar y qué información te pasan los widgets, o cuando escribas un widget compatible con estilos o un delegado, para dibujar los mismos elementos que dibujan los widgets de Qt.

La referencia se divide en tres páginas:

  • Estilos para botones y controles de entrada: botones pulsadores, casillas de selección y botones de opción, botones de herramientas, cuadros combinados, cuadros giratorios, controles deslizantes, barras de desplazamiento y barras de progreso.
  • Estilo de contenedores y ventanas: widgets de pestañas, cuadros de grupo, divisores, cajas de herramientas, barras de herramientas, widgets acoplables, barras de título, controles de tamaño y bandas elásticas.
  • Estilo de menús y vistas de elementos: menús, barras de menús, encabezados de vistas de elementos, indicadores de ramas de árbol y elementos de vistas de elementos.

Lo que incluye la referencia de cada widget

  • El árbol de elementos. Los elementos de estilo que dibuja el widget, en orden de dibujo. Un elemento anidado es dibujado por el elemento situado encima de él en QCommonStyle. Junto a cada elemento, la referencia indica los rectángulos de los subelementos, los subcontroles y las métricas de píxeles que utiliza QCommonStyle al dibujar ese elemento. Tu propio estilo puede estructurar su dibujo de forma diferente; solo los elementos que llama el widget son fijos.
  • Una captura de pantalla. El widget en el estilo «Fusion», con los rectángulos delimitadores de los elementos resaltados. Los colores solo sirven para distinguir los rectángulos. Los rectángulos que coinciden se dibujan un píxel dentro unos de otros.
  • Los indicadores de estado. Los valores de « QStyle::StateFlag » que el widget establece en su opción de estilo, además de los indicadores comunes que establece QStyleOption::initFrom().
  • Los miembros de la opción de estilo. Los miembros de la subclase QStyleOption del widget y lo que el widget almacena en ellos.

Los indicadores de estado comunes y los miembros se describen en «Cómo dibuja un estilo un widget».

Lo que omite la referencia

Los widgets también utilizan el estilo para cálculos que no forman parte del dibujo. Solicitan sus sugerencias de tamaño con ` sizeFromContents()`; los anchos de marco y los márgenes con ` pixelMetric()`; y la posición de sus subelementos con ` subElementRect()`. La referencia enumera los tipos de contenido y las métricas en píxeles que consulta cada widget, pero no describe cómo los estilos integrados los calculan. La forma en que un estilo realiza esos cálculos depende del propio estilo. Qt no impone una estructura concreta. En caso de duda, consulta la implementación de ` QCommonStyle `.

Véase también «Estilos y widgets sensibles al estilo», «Cómo dibuja un estilo un widget», QStyle y QStyleOption.

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