QStyleOptionTab Class
La clase QStyleOptionTab se utiliza para definir los parámetros de dibujo de una barra de pestañas. Más información...
| Encabezado: | #include <QStyleOptionTab> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | 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) | |
| QStyleOptionTab & | operator=(const QStyleOptionTab &) |
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 integrados de Qt, entre los que se incluyen QTabBar y el panel de 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 es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos. La versión la utilizan las subclases de ` QStyleOption ` para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.
Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante los operadores . o -> ). Esto hace que las estructuras sean fáciles de usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación sobre los tipos de miembros
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
Estas marcas indican los widgets de las esquinas de una pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | No hay widgets de esquina |
QStyleOptionTab::LeftCornerWidget | 0x01 | Widget de la 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 de CornerWidget.
Véase también cornerWidgets.
enum QStyleOptionTab::SelectedPosition
Esta enumeración describe la posición de la pestaña seleccionada. Algunos estilos deben dibujar una pestaña de forma diferente dependiendo de si está o no junto a la pestaña seleccionada.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | La pestaña no está junto 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
Esta enumeración se utiliza para almacenar 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 lo utilizan internamente ` QStyleOption`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOptionTab::StyleOptionVersion
Esta enumeración se utiliza para almacenar 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 |
Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.
Véase 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á situado en un marco de pestañas |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | Se está midiendo la sugerencia de tamaño mínimo del botón de pestaña, a diferencia de su sugerencia de tamaño normal. |
El tipo TabFeatures es una definición de tipo (typedef) para QFlags<TabFeature>. Almacena una combinación OR de valores de TabFeature.
Véase también QStyleOptionToolBar::features.
enum QStyleOptionTab::TabPosition
Esta enumeración describe la posición de la pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionTab::Beginning | 0 | La pestaña es la primera 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 de la barra de pestañas. |
QStyleOptionTab::OnlyOneTab | 3 | La pestaña es a la vez la primera y la última de la barra de pestañas. |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | La pestaña se está moviendo al arrastrarla con el ratón o mediante una animación. |
Véase también position.
Documentación de funciones de miembro
QStyleOptionTab::QStyleOptionTab()
Crea un objeto QStyleOptionTab e inicializa las variables de miembro con sus valores por defecto.
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Crea una copia de la opción de estilo « other ».
[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)
Asigna por copia « other » a esta instancia de « QStyleOptionTab ».
Documentación sobre variables de miembro
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Esta variable contiene una combinación «OR» de valores de « 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 se encuentra 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 que no tiene ni 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; utiliza QStyle::pixelMetric() para averiguar el tamaño predeterminado de los iconos de las barras de pestañas.
Véase también QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Esta variable contiene el tamaño del widget de la izquierda en 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 de la barra de pestañas.
QSize QStyleOptionTab::rightButtonSize
Esta variable contiene el tamaño del widget de la derecha en 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, lo que indica la fila delantera. Actualmente, esta propiedad solo puede tomar el valor 0.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Esta variable contiene la posición de la pestaña seleccionada con respecto a esta pestaña
El valor por defecto es NotAdjacent, es decir, la pestaña no está adyacente a una pestaña seleccionada ni es la pestaña seleccionada.
QTabBar::Shape QStyleOptionTab::shape
Esta variable contiene la forma de la pestaña que se utiliza para dibujarla; 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á mostrando.
El valor por defecto es -1, es decir, una pestaña que no se encuentra 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.