En esta página

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.

ConstanteValorDescripción
QStyleOptionTab::NoCornerWidgets0x00No hay widgets de esquina
QStyleOptionTab::LeftCornerWidget0x01Widget de la esquina izquierda
QStyleOptionTab::RightCornerWidget0x02Widget 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.

ConstanteValorDescripción
QStyleOptionTab::NotAdjacent0La pestaña no está junto a una pestaña seleccionada (o es la pestaña seleccionada).
QStyleOptionTab::NextIsSelected1La pestaña siguiente (normalmente la pestaña de la derecha) está seleccionada.
QStyleOptionTab::PreviousIsSelected2La 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 `.

ConstanteValorDescripción
QStyleOptionTab::TypeSO_TabEl 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 `.

ConstanteValorDescripción
QStyleOptionTab::Version13

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.

ConstanteValorDescripción
QStyleOptionTab::None0x00Un botón de pestaña normal.
QStyleOptionTab::HasFrame0x01El botón de pestaña está situado en un marco de pestañas
QStyleOptionTab::MinimumSizeHint (since Qt 6.9)0x02Se 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.

ConstanteValorDescripción
QStyleOptionTab::Beginning0La pestaña es la primera de la barra de pestañas.
QStyleOptionTab::Middle1La pestaña no es ni la primera ni la última de la barra de pestañas.
QStyleOptionTab::End2La pestaña es la última de la barra de pestañas.
QStyleOptionTab::OnlyOneTab3La pestaña es a la vez la primera y la última de la barra de pestañas.
QStyleOptionTab::Moving (since Qt 6.6)4La 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.