QStyleOptionTab Class
La clase QStyleOptionTab se utiliza para describir los parámetros para dibujar una barra de pestañas. Más...
| Cabecera: | #include <QStyleOptionTab> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QStyleOption |
Tipos Públicos
| enum | CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget } |
| flags | CornerWidgets |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | TabFeature { None, HasFrame, MinimumSizeHint } |
| flags | TabFeatures |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab, Moving } |
Funciones Públicas
| QStyleOptionTab() | |
| QStyleOptionTab(const QStyleOptionTab &other) |
Variables Públicas
| QStyleOptionTab::CornerWidgets | cornerWidgets |
| bool | documentMode |
| QIcon | icon |
| QSize | iconSize |
| QSize | leftButtonSize |
| QStyleOptionTab::TabPosition | position |
| QSize | rightButtonSize |
| int | row |
| QStyleOptionTab::SelectedPosition | selectedPosition |
| QTabBar::Shape | shape |
| int | tabIndex |
| QString | text |
Descripción Detallada
La clase QStyleOptionTab se utiliza para dibujar varios widgets incorporados en Qt incluyendo QTabBar y el panel para QTabWidget.
Una instancia de la clase QStyleOptionTab tiene type SO_Tab y version 3. El tipo es utilizado internamente por QStyleOption, sus subclases, y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos. La versión es utilizada por las subclases QStyleOption para implementar extensiones sin romper la compatibilidad. Si utilizas qstyleoption_cast(), normalmente no necesitas comprobarlo.
Por razones de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, utilizando el operador . o -> ). Esto hace que las estructuras sean sencillas de utilizar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación de tipos de miembros
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
Estas banderas indican los widgets de esquina en una pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | No hay widgets de esquina |
QStyleOptionTab::LeftCornerWidget | 0x01 | Widget de esquina izquierda |
QStyleOptionTab::RightCornerWidget | 0x02 | Widget de esquina derecha |
El tipo CornerWidgets es un typedef para QFlags<CornerWidget>. Almacena una combinación OR de valores CornerWidget.
Véase también cornerWidgets.
enum QStyleOptionTab::SelectedPosition
Este enum describe la posición de la pestaña seleccionada. Algunos estilos necesitan dibujar una pestaña de forma diferente dependiendo de si está o no adyacente a la pestaña seleccionada.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | La pestaña no es adyacente a una pestaña seleccionada (o es la pestaña seleccionada). |
QStyleOptionTab::NextIsSelected | 1 | La pestaña siguiente (normalmente la pestaña de la derecha) está seleccionada. |
QStyleOptionTab::PreviousIsSelected | 2 | La pestaña anterior (normalmente la pestaña de la izquierda) está seleccionada. |
Véase también selectedPosition.
enum QStyleOptionTab::StyleOptionType
Este enum se utiliza para guardar información sobre el tipo de la opción de estilo, y se define para cada subclase de QStyleOption.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | El tipo de opción de estilo proporcionada (SO_Tab para esta clase). |
El tipo es utilizado internamente por QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOptionTab::StyleOptionVersion
Este enum se utiliza para guardar información sobre la versión de la opción de estilo, y se define para cada subclase de QStyleOption.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::Version | 1 | 3 |
La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.
Ver también StyleOptionType.
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
Describe las distintas características que puede tener un botón de pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::None | 0x00 | Un botón de pestaña normal. |
QStyleOptionTab::HasFrame | 0x01 | El botón de pestaña está posicionado en un marco de pestaña. |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | Se está midiendo la sugerencia de tamaño mínimo del botón de pestaña, en contraste con su sugerencia de tamaño normal. |
El tipo TabFeatures es un typedef para QFlags<TabFeature>. Almacena una combinación OR de valores TabFeature.
Véase también QStyleOptionToolBar::features.
enum QStyleOptionTab::TabPosition
Este enum describe la posición de la pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::Beginning | 0 | La pestaña es la primera pestaña de la barra de pestañas. |
QStyleOptionTab::Middle | 1 | La pestaña no es ni la primera ni la última de la barra de pestañas. |
QStyleOptionTab::End | 2 | La pestaña es la última pestaña de la barra de pestañas. |
QStyleOptionTab::OnlyOneTab | 3 | La pestaña es tanto la primera como la última de la barra de pestañas. |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | La pestaña se mueve por arrastre o animación del ratón. |
Véase también position.
Documentación de las funciones miembro
QStyleOptionTab::QStyleOptionTab()
Construye un objeto QStyleOptionTab, inicializando las variables miembros a sus valores por defecto.
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Construye una copia de la opción de estilo other.
Documentación de la variable miembro
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Esta variable contiene una combinación OR de valores CornerWidget que indican los widgets de las esquinas de la barra de pestañas
El valor por defecto es NoCornerWidgets.
Véase también CornerWidget.
bool QStyleOptionTab::documentMode
Esta variable indica si la barra de pestañas está en modo documento.
El valor por defecto es false;
QIcon QStyleOptionTab::icon
Esta variable contiene el icono de la pestaña
El valor por defecto es un icono vacío, es decir, un icono sin mapa de píxeles ni nombre de archivo.
QSize QStyleOptionTab::iconSize
Esta variable contiene el tamaño de los iconos
El valor por defecto es QSize(-1, -1), es decir, un tamaño no válido; utilice QStyle::pixelMetric() para encontrar el tamaño por defecto de los iconos para las barras de pestañas.
Véase también QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Esta variable contiene el tamaño del widget izquierdo de la pestaña.
El valor por defecto es QSize(-1, -1), es decir, un tamaño no válido;
QStyleOptionTab::TabPosition QStyleOptionTab::position
Esta variable contiene la posición de la pestaña en la barra de pestañas
El valor por defecto es Beginning, es decir, la pestaña es la primera pestaña de la barra de pestañas.
QSize QStyleOptionTab::rightButtonSize
Esta variable contiene el tamaño del widget derecho de la pestaña.
El valor por defecto es QSize(-1, -1), es decir, un tamaño no válido;
int QStyleOptionTab::row
Esta variable indica en qué fila se encuentra actualmente la pestaña
El valor por defecto es 0, indicando la primera fila. Actualmente esta propiedad sólo puede ser 0.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Esta variable contiene la posición de la pestaña seleccionada en relación con esta pestaña
El valor por defecto es NotAdjacent, es decir, la pestaña no es adyacente a una pestaña seleccionada ni es la pestaña seleccionada.
QTabBar::Shape QStyleOptionTab::shape
Esta variable contiene la forma de tabulación utilizada para dibujar la tabulación; por defecto QTabBar::RoundedNorth.
Véase también QTabBar::Shape.
int QStyleOptionTab::tabIndex
Esta variable contiene el índice de la pestaña que se está representando.
El valor por defecto es -1, es decir, una pestaña que no está en una barra de pestañas;
QString QStyleOptionTab::text
Esta variable contiene el texto de la pestaña
El valor por defecto es una cadena vacía.
© 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.
