QTabBar Class
La clase QTabBar proporciona una barra de pestañas, por ejemplo, para su uso en cuadros de diálogo con pestañas. Más información...
| Encabezado: | #include <QTabBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QWidget |
Tipos públicos
| enum | ButtonPosition { LeftSide, RightSide } |
| enum | SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab } |
| enum | Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, TriangularNorth, …, TriangularEast } |
Propiedades
|
|
Funciones públicas
| QTabBar(QWidget *parent = nullptr) | |
| virtual | ~QTabBar() |
| QString | accessibleTabName(int index) const |
| int | addTab(const QString &text) |
| int | addTab(const QIcon &icon, const QString &text) |
| bool | autoHide() const |
| bool | changeCurrentOnDrag() const |
| int | count() const |
| int | currentIndex() const |
| bool | documentMode() const |
| bool | drawBase() const |
| Qt::TextElideMode | elideMode() const |
| bool | expanding() const |
| QSize | iconSize() const |
| int | insertTab(int index, const QString &text) |
| int | insertTab(int index, const QIcon &icon, const QString &text) |
| bool | isMovable() const |
| bool | isTabEnabled(int index) const |
| bool | isTabVisible(int index) const |
| void | moveTab(int from, int to) |
| void | removeTab(int index) |
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setAccessibleTabName(int index, const QString &name) |
| void | setAutoHide(bool hide) |
| void | setChangeCurrentOnDrag(bool change) |
| void | setDocumentMode(bool set) |
| void | setDrawBase(bool drawTheBase) |
| void | setElideMode(Qt::TextElideMode mode) |
| void | setExpanding(bool enabled) |
| void | setIconSize(const QSize &size) |
| void | setMovable(bool movable) |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
| void | setShape(QTabBar::Shape shape) |
| void | setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget) |
| void | setTabData(int index, const QVariant &data) |
| void | setTabEnabled(int index, bool enabled) |
| void | setTabIcon(int index, const QIcon &icon) |
| void | setTabText(int index, const QString &text) |
| void | setTabTextColor(int index, const QColor &color) |
| void | setTabToolTip(int index, const QString &tip) |
| void | setTabVisible(int index, bool visible) |
| void | setTabWhatsThis(int index, const QString &text) |
| void | setTabsClosable(bool closable) |
| void | setUsesScrollButtons(bool useButtons) |
| QTabBar::Shape | shape() const |
| int | tabAt(const QPoint &position) const |
| QWidget * | tabButton(int index, QTabBar::ButtonPosition position) const |
| QVariant | tabData(int index) const |
| QIcon | tabIcon(int index) const |
| QRect | tabRect(int index) const |
| QString | tabText(int index) const |
| QColor | tabTextColor(int index) const |
| QString | tabToolTip(int index) const |
| QString | tabWhatsThis(int index) const |
| bool | tabsClosable() const |
| bool | usesScrollButtons() const |
Funciones públicas reimplementadas
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Ranuras públicas
| void | setCurrentIndex(int index) |
Señales
| void | currentChanged(int index) |
| void | tabBarClicked(int index) |
| void | tabBarDoubleClicked(int index) |
| void | tabCloseRequested(int index) |
| void | tabMoved(int from, int to) |
Funciones protegidas
| virtual void | initStyleOption(QStyleOptionTab *option, int tabIndex) const |
| virtual QSize | minimumTabSizeHint(int index) const |
| virtual void | tabInserted(int index) |
| virtual void | tabLayoutChange() |
| virtual void | tabRemoved(int index) |
| virtual QSize | tabSizeHint(int index) const |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual void | hideEvent(QHideEvent *) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *) override |
| virtual void | resizeEvent(QResizeEvent *) override |
| virtual void | showEvent(QShowEvent *) override |
| virtual void | timerEvent(QTimerEvent *event) override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Descripción detallada
QTabBar es muy sencillo de usar; dibuja las pestañas utilizando una de las funciones predefinidas shapes y emite una señal cuando se selecciona una pestaña. Se pueden crear subclases para personalizar su aspecto. Qt también proporciona una clase ya preparada QTabWidget.
Cada pestaña tiene un ` tabText()`, un ` tabIcon()` opcional, un ` tabToolTip()` opcional, un ` tabWhatsThis()` opcional y un ` tabData()` opcional. Los atributos de las pestañas se pueden modificar con ` setTabText()`, ` setTabIcon()`, ` setTabToolTip()`, ` setTabWhatsThis ` y ` setTabData()`. Cada pestaña se puede activar o desactivar individualmente con ` setTabEnabled()`.
Cada pestaña puede mostrar el texto en un color distinto. El color actual del texto de una pestaña se puede consultar con la función tabTextColor(). Para establecer el color del texto de una pestaña concreta, utilice setTabTextColor().
Las pestañas se añaden mediante ` addTab()`, o se insertan en posiciones concretas mediante ` insertTab()`. El número total de pestañas se obtiene con ` count()`. Las pestañas se pueden eliminar de la barra de pestañas con ` removeTab()`. La combinación de ` removeTab()` y ` insertTab()` permite mover las pestañas a diferentes posiciones.
La propiedad shape define el aspecto de las pestañas. La elección de la forma es cuestión de gustos, aunque los cuadros de diálogo de pestañas (para preferencias y similares) utilizan invariablemente RoundedNorth. Los controles de pestañas en ventanas que no sean cuadros de diálogo casi siempre utilizan RoundedSouth o TriangularSouth. Muchas hojas de cálculo y otros controles de pestañas en los que todas las páginas son esencialmente similares utilizan TriangularSouth, mientras que RoundedSouth se utiliza principalmente cuando las páginas son diferentes (por ejemplo, una paleta de herramientas de varias páginas). El valor por defecto en QTabBar es RoundedNorth.
La parte más importante de la API de QTabBar es la señal currentChanged(). Esta se emite cada vez que cambia la pestaña actual (incluso al iniciarse la aplicación, cuando la pestaña actual pasa de «ninguna»). También hay una ranura, setCurrentIndex(), que se puede utilizar para seleccionar una pestaña mediante programación. La función currentIndex() devuelve el índice de la pestaña actual, mientras que count contiene el número de pestañas.
QTabBar crea teclas mnemotécnicas automáticas al estilo de QAbstractButton; por ejemplo, si la etiqueta de una pestaña es «&Graphics», Alt+G se convierte en una tecla de acceso rápido para cambiar a esa pestaña.
Es posible que sea necesario reimplementar las siguientes funciones virtuales para personalizar la apariencia o almacenar datos adicionales en cada pestaña:
- tabSizeHint() calcula el tamaño de una pestaña.
- tabInserted() notifica que se ha añadido una nueva pestaña.
- tabRemoved() notifica que se ha eliminado una pestaña.
- tabLayoutChange() notifica que se ha reorganizado la disposición de las pestañas.
- paintEvent() dibuja todas las pestañas.
Para las subclases, es posible que también necesites las funciones ` tabRect()` y `()`, que devuelven la geometría visual de una sola pestaña.
![]() | Una barra de pestañas mostrada con el estilo de widget «Fusion». |
![]() | Una barra de pestañas truncada mostrada con el estilo de widget Fusion. |
Véase también QTabWidget.
Documentación sobre los tipos de miembro
enum QTabBar::ButtonPosition
Este tipo de enumeración indica la ubicación del widget en una pestaña.
| Constante | Valor | Descripción |
|---|---|---|
QTabBar::LeftSide | 0 | Lado izquierdo de la pestaña. |
QTabBar::RightSide | 1 | Lado derecho de la pestaña. |
enum QTabBar::SelectionBehavior
Este tipo de enumeración enumera los comportamientos de QTabBar cuando se elimina una pestaña y la pestaña que se elimina es también la pestaña actual.
| Constante | Valor | Descripción |
|---|---|---|
QTabBar::SelectLeftTab | 0 | Selecciona la pestaña situada a la izquierda de la que se va a eliminar. |
QTabBar::SelectRightTab | 1 | Selecciona la pestaña situada a la derecha de la que se va a eliminar. |
QTabBar::SelectPreviousTab | 2 | Selecciona la pestaña seleccionada anteriormente. |
enum QTabBar::Shape
Este tipo de enumeración enumera las formas integradas compatibles con QTabBar. Tómalas como recomendaciones, ya que es posible que algunos estilos no muestren correctamente algunas de las formas. No obstante, la posición sí debe respetarse.
| Constante | Valor | Descripción |
|---|---|---|
QTabBar::RoundedNorth | 0 | El aspecto redondeado habitual en la parte superior de las páginas |
QTabBar::RoundedSouth | 1 | El aspecto redondeado habitual debajo de las páginas |
QTabBar::RoundedWest | 2 | El aspecto redondeado habitual en el lado izquierdo de las páginas |
QTabBar::RoundedEast | 3 | El aspecto redondeado habitual en el lado derecho de las páginas |
QTabBar::TriangularNorth | 4 | Pestañas triangulares en la parte superior de las páginas. |
QTabBar::TriangularSouth | 5 | Pestañas triangulares similares a las que se utilizan, por ejemplo, en las hojas de cálculo de Excel |
QTabBar::TriangularWest | 6 | Pestañas triangulares a la izquierda de las páginas. |
QTabBar::TriangularEast | 7 | Pestañas triangulares a la derecha de las páginas. |
Documentación de propiedades
autoHide : bool
Si el valor es «true», la barra de pestañas se oculta automáticamente cuando contiene menos de 2 pestañas.
Por defecto, esta propiedad es «false».
Funciones de Access:
| bool | autoHide() const |
| void | setAutoHide(bool hide) |
Véase también QWidget::visible.
changeCurrentOnDrag : bool
Si el valor es «true», la pestaña actual cambia automáticamente al arrastrar el cursor sobre la barra de pestañas.
Nota: Para que esta función funcione, también debes establecer la propiedad «acceptDrops» en «true».
Por defecto, esta propiedad está establecida en «false».
Funciones de acceso:
| bool | changeCurrentOnDrag() const |
| void | setChangeCurrentOnDrag(bool change) |
[read-only] count : int
Esta propiedad contiene el número de pestañas de la barra de pestañas
Funciones de acceso:
| int | count() const |
currentIndex : int
Esta propiedad contiene el índice de la pestaña visible de la barra de pestañas
El índice actual es -1 si no hay ninguna pestaña activa.
Funciones de acceso:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Señal de notificación:
| void | currentChanged(int index) |
documentMode : bool
Esta propiedad indica si la barra de pestañas se representa o no en un modo adecuado para la ventana principal.
Esta propiedad se utiliza como indicación para que los estilos dibujen las pestañas de una forma diferente a como se verían normalmente en un widget de pestañas. En macOS, el aspecto será similar al de las pestañas de Safari o de la aplicación Terminal.app de Sierra.
Funciones de acceso:
| bool | documentMode() const |
| void | setDocumentMode(bool set) |
Véase también QTabWidget::documentMode.
drawBase : bool
Define si la barra de pestañas debe mostrar o no su base.
Si es «true», entonces « QTabBar » dibuja una base en función de la superposición de estilos. De lo contrario, solo se dibujan las pestañas.
Funciones de acceso:
| bool | drawBase() const |
| void | setDrawBase(bool drawTheBase) |
Véase también QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap y QStyleOptionTabBarBase.
elideMode : Qt::TextElideMode
Cómo omitir texto en la barra de pestañas
Esta propiedad controla cómo se omiten los elementos cuando no hay espacio suficiente para mostrarlos en una barra de pestañas de un tamaño determinado.
Por defecto, el valor depende del estilo.
Funciones de Access:
| Qt::TextElideMode | elideMode() const |
| void | setElideMode(Qt::TextElideMode mode) |
Véase también QTabWidget::elideMode, usesScrollButtons y QStyle::SH_TabBar_ElideMode.
expanding : bool
Cuando la opción «expandir» está activada, QTabBar ampliará las pestañas para aprovechar el espacio libre.
Por defecto, el valor es «true».
Funciones de Access:
| bool | expanding() const |
| void | setExpanding(bool enabled) |
Véase también QTabWidget::documentMode.
iconSize : QSize
Esta propiedad define el tamaño de los iconos de la barra de pestañas
El valor por defecto depende del estilo. « iconSize » es el tamaño máximo; los iconos que sean más pequeños no se ampliarán.
Funciones de acceso:
| QSize | iconSize() const |
| void | setIconSize(const QSize &size) |
Véase también QTabWidget::iconSize.
movable : bool
Esta propiedad determina si el usuario puede mover las pestañas dentro del área de la barra de pestañas.
Por defecto, esta propiedad tiene el valor « false »;
Funciones de Access:
| bool | isMovable() const |
| void | setMovable(bool movable) |
selectionBehaviorOnRemove : SelectionBehavior
¿Qué pestaña debe establecerse como actual cuando se llama a ` removeTab ` si la pestaña eliminada es también la pestaña actual?
Por defecto, el valor es ` SelectRightTab`.
Funciones de acceso:
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
Véase también removeTab().
shape : Shape
Esta propiedad define la forma de las pestañas en la barra de pestañas
Los valores posibles para esta propiedad se describen en la enumeración Shape.
Funciones de acceso:
| QTabBar::Shape | shape() const |
| void | setShape(QTabBar::Shape shape) |
tabsClosable : bool
Esta propiedad determina si una barra de pestañas debe mostrar botones de cierre en cada pestaña
Cuando «tabsClosable» se establece en «true», aparecerá un botón de cierre en la pestaña, ya sea en el lado izquierdo o en el derecho, dependiendo del estilo. Al hacer clic directamente en el botón, o al pulsar el botón central del ratón en cualquier parte de la pestaña, se emitirá la señal « tabCloseRequested ».
Por defecto, el valor es «false».
Funciones de acceso:
| bool | tabsClosable() const |
| void | setTabsClosable(bool closable) |
Véase también ` setTabButton()` y ` tabRemoved()`.
usesScrollButtons : bool
Esta propiedad determina si una barra de pestañas debe utilizar botones para desplazarse por las pestañas cuando hay muchas de ellas.
Cuando hay demasiadas pestañas en una barra de pestañas para su tamaño, la barra de pestañas puede optar por ampliar su tamaño o por añadir botones que permitan desplazarse por las pestañas.
Por defecto, el valor depende del estilo.
Funciones de acceso:
| bool | usesScrollButtons() const |
| void | setUsesScrollButtons(bool useButtons) |
Véase también elideMode, QTabWidget::usesScrollButtons y QStyle::SH_TabBar_PreferNoArrows.
Documentación de funciones de miembro
[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)
Crea una nueva barra de pestañas con el « parent » indicado.
[virtual noexcept] QTabBar::~QTabBar()
Elimina la barra de pestañas.
QString QTabBar::accessibleTabName(int index) const
Devuelve el «accessibleName» de la pestaña situada en la posición index, o una cadena vacía si index está fuera de rango.
Véase también setAccessibleTabName().
int QTabBar::addTab(const QString &text)
Añade una nueva pestaña con el texto « text ». Devuelve el índice de la nueva pestaña.
int QTabBar::addTab(const QIcon &icon, const QString &text)
Añade una nueva pestaña con el icono « icon » y el texto « text ». Devuelve el índice de la nueva pestaña.
Esta es una función sobrecargada.
[override virtual protected] void QTabBar::changeEvent(QEvent *event)
Reimplementa: ` QWidget::changeEvent(QEvent *event)`.
[signal] void QTabBar::currentChanged(int index)
Esta señal se emite cuando cambia la pestaña activa de la barra de pestañas. La nueva pestaña activa tiene el valor de « index » indicado, o -1 si no hay ninguna nueva (por ejemplo, si no hay ninguna pestaña en « QTabBar »).
Nota: Señalde notificación para la propiedad currentIndex.
[override virtual protected] bool QTabBar::event(QEvent *event)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QTabBar::hideEvent(QHideEvent *)
Reimplementa: ` QWidget::hideEvent(QHideEvent *event)`.
[virtual protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const
Inicializa ` option ` con los valores de la pestaña de tabIndex. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionTab`, pero no quieren introducir toda la información ellas mismas.
Véase también QStyleOption::initFrom() y QTabWidget::initStyleOption().
int QTabBar::insertTab(int index, const QString &text)
Inserta una nueva pestaña con el texto « text » en la posición « index ». Si « index » está fuera de rango, la nueva pestaña se añade al final. Devuelve el índice de la nueva pestaña.
int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)
Inserta una nueva pestaña con el icono icon y el texto text en la posición index. Si index está fuera de rango, la nueva pestaña se añade al final. Devuelve el índice de la nueva pestaña.
Si QTabBar estaba vacío antes de llamar a esta función, la pestaña insertada se convierte en la pestaña actual.
Al insertar una nueva pestaña en un índice menor o igual que el índice actual, este se incrementará, pero se mantendrá la pestaña actual.
Esta es una función sobrecargada.
bool QTabBar::isTabEnabled(int index) const
Devuelve « true » si la pestaña situada en la posición « index » está activada; en caso contrario, devuelve « false ».
bool QTabBar::isTabVisible(int index) const
Devuelve «true» si la pestaña situada en la posición index está visible; en caso contrario, devuelve «false».
[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)
Reimplementa: ` QWidget::keyPressEvent(QKeyEvent *event)`.
[override virtual] QSize QTabBar::minimumSizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.
[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const
Devuelve el tamaño mínimo recomendado para la pestaña situada en la posición index.
[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)
Reimplementa: ` QWidget::mouseDoubleClickEvent(QMouseEvent *event)`.
[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)
Reimplementa: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.
[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)
Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)
Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.
void QTabBar::moveTab(int from, int to)
Mueve el elemento de la posición de índice from a la posición de índice to.
Véase también tabMoved() y tabLayoutChange().
[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
void QTabBar::removeTab(int index)
Elimina la pestaña situada en la posición index.
Véase también SelectionBehavior.
[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)
Reimplementa: ` QWidget::resizeEvent(QResizeEvent *event)`.
void QTabBar::setAccessibleTabName(int index, const QString &name)
Establece el «accessibleName» de la pestaña situada en la posición index como name.
Véase también accessibleTabName().
void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)
Establece « widget » en la pestaña « index ». El widget se coloca a la izquierda o a la derecha, dependiendo de la opción « position ».
Cualquier widget establecido previamente en « position » queda oculto. Al establecer « widget » en « nullptr », se ocultará el widget actual en « position ».
La barra de pestañas asumirá la propiedad del widget, por lo que todos los widgets establecidos aquí serán eliminados por la barra de pestañas cuando esta se destruya, a menos que se cambie la propiedad del widget por separado después de establecer algún otro widget (o nullptr).
Véanse también tabButton() y tabsClosable().
void QTabBar::setTabData(int index, const QVariant &data)
Establece los datos de la pestaña situada en la posición index en data.
Véase también tabData().
void QTabBar::setTabEnabled(int index, bool enabled)
Si enabled es verdadero, la pestaña situada en index está activada; en caso contrario, el elemento situado en index está desactivado.
Véase también isTabEnabled().
void QTabBar::setTabIcon(int index, const QIcon &icon)
Establece el icono de la pestaña situada en la posición index como icon.
Véase también tabIcon().
void QTabBar::setTabText(int index, const QString &text)
Establece el texto de la pestaña situada en la posición index como text.
Véase también tabText().
void QTabBar::setTabTextColor(int index, const QColor &color)
Establece el color del texto de la pestaña con el rol de color de primer plano « index » en el color de fondo especificado « color ».
Si se especifica un color no válido, la pestaña utilizará en su lugar el color de primer plano de QTabBar.
Véase también tabTextColor().
void QTabBar::setTabToolTip(int index, const QString &tip)
Establece la descripción emergente de la pestaña situada en la posición index en tip.
Véase también tabToolTip().
void QTabBar::setTabVisible(int index, bool visible)
Si visible es verdadero, haz visible la pestaña situada en la posición index; en caso contrario, ocúltala.
Véase también isTabVisible().
void QTabBar::setTabWhatsThis(int index, const QString &text)
Establece el texto de ayuda «¿Qué es esto?» de la pestaña situada en la posición index en text.
Véase también tabWhatsThis().
[override virtual protected] void QTabBar::showEvent(QShowEvent *)
Reimplementa: ` QWidget::showEvent(QShowEvent *event)`.
[override virtual] QSize QTabBar::sizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.
int QTabBar::tabAt(const QPoint &position) const
Devuelve el índice de la pestaña que cubre position o -1 si ninguna pestaña cubre position;
[signal] void QTabBar::tabBarClicked(int index)
Esta señal se emite cuando el usuario hace clic en una pestaña en index.
index Es el índice de la pestaña en la que se ha hecho clic, o -1 si no hay ninguna pestaña bajo el cursor.
[signal] void QTabBar::tabBarDoubleClicked(int index)
Esta señal se emite cuando el usuario hace doble clic en una pestaña en index.
index Hace referencia a la pestaña en la que se ha hecho clic, o -1 si no hay ninguna pestaña bajo el cursor.
QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const
Devuelve la pestaña asignada al widget index y position o nullptr si no se ha asignado ninguna.
Véase también setTabButton().
[signal] void QTabBar::tabCloseRequested(int index)
Esta señal se emite al hacer clic en el botón de cierre de una pestaña. El objeto ` index ` es el índice que debe eliminarse.
Véase también setTabsClosable().
QVariant QTabBar::tabData(int index) const
Devuelve los datos de la pestaña situada en la posición index, o una variante nula si index está fuera de rango.
Véase también setTabData().
QIcon QTabBar::tabIcon(int index) const
Devuelve el icono de la pestaña situada en la posición index, o un icono nulo si index está fuera de rango.
Véase también setTabIcon().
[virtual protected] void QTabBar::tabInserted(int index)
Este controlador virtual se ejecuta después de que se haya añadido o insertado una nueva pestaña en la posición index.
Véase también tabRemoved().
[virtual protected] void QTabBar::tabLayoutChange()
Este controlador virtual se activa cada vez que cambia la disposición de las pestañas.
Véase también tabRect().
[signal] void QTabBar::tabMoved(int from, int to)
Esta señal se emite cuando la pestaña se ha desplazado de la posición de índice from a la posición de índice to.
Nota: QTabWidget desplazará automáticamente la página cuando se emita esta señal desde su barra de pestañas.
Véase también moveTab().
QRect QTabBar::tabRect(int index) const
Devuelve el rectángulo visual de la pestaña situada en la posición index, o un rectángulo nulo si index está oculta o fuera de rango.
[virtual protected] void QTabBar::tabRemoved(int index)
Este controlador virtual se ejecuta después de que se haya eliminado una tabulación de la posición index.
Véase también tabInserted().
[virtual protected] QSize QTabBar::tabSizeHint(int index) const
Devuelve la indicación de tamaño de la pestaña situada en la posición index.
QString QTabBar::tabText(int index) const
Devuelve el texto de la pestaña situada en la posición index, o una cadena vacía si index está fuera de rango.
Véase también setTabText().
QColor QTabBar::tabTextColor(int index) const
Devuelve el color del texto de la pestaña con el valor dado index, o un color no válido si index está fuera de rango.
Véase también setTabTextColor().
QString QTabBar::tabToolTip(int index) const
Devuelve la descripción emergente de la pestaña situada en la posición index, o una cadena vacía si index está fuera de rango.
Véase también setTabToolTip().
QString QTabBar::tabWhatsThis(int index) const
Devuelve el texto de ayuda «¿Qué es esto?» de la pestaña situada en la posición index, o una cadena vacía si index está fuera de rango.
Véase también setTabWhatsThis().
[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)
Reimplementa: QObject::timerEvent(QTimerEvent *event).
[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)
Reimplementa: QWidget::wheelEvent(QWheelEvent *event).
© 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.

