QTabBar 类

成员函数文档

[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)

创建一个新的带有指定 parent 的标签栏。

[virtual noexcept] QTabBar::~QTabBar()

销毁标签栏。

QString QTabBar::accessibleTabName(int index) const

返回位置为 index 的标签的可访问名称，如果 index 超出范围，则返回空字符串。

参见setAccessibleTabName()。

int QTabBar::addTab(const QString &text)

添加一个带有文本 text 的新标签。返回新标签的索引。

int QTabBar::addTab(const QIcon &icon, const QString &text)

这是一个重载函数。

添加一个带有图标 icon 和文本 text 的新标签。返回新标签的索引。

[覆盖虚拟保护] void QTabBar::changeEvent(QEvent *event)

重实现：QWidget::changeEvent(QEvent *event).

[信号] void QTabBar::currentChanged(int index)

当标签栏当前标签改变时发出此信号。新的当前标签具有给定的 index，如果没有新的一个（例如，如果没有任何标签在 QTabBar 中），则为 -1

[覆盖虚拟保护] bool QTabBar::event(QEvent *event)

重实现：QWidget::event(QEvent *event).

[覆盖虚拟保护] void QTabBar::hideEvent(QHideEvent *)

重实现：QWidget::hideEvent(QHideEvent *event).

[虚拟保护] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const

使用位于 tabIndex 的标签的值初始化 option。此方法对于子类在需要 QStyleOptionTab 时非常有用，但不想填写所有信息。

参见QStyleOption::initFrom() 和 QTabWidget::initStyleOption。

int QTabBar::insertTab(int index, const QString &text)

在位置 index 插入一个带有文本 text 的新标签。如果 index 超出范围，则将新标签添加到末尾。返回新标签的索引。

int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)

这是一个重载函数。

在位置 index 插入一个带有图标 icon 和文本 text 的新标签。如果 index 超出范围，则将新标签添加到末尾。返回新标签的索引。

如果在此函数调用之前 QTabBar 为空，则插入的标签变为当前标签。

在小于或等于当前索引的索引处插入新标签将增加当前索引，但保持当前标签。

bool QTabBar::isTabEnabled(int index) const

如果位置 index 的标签被启用，则返回 true；否则返回 false。

bool QTabBar::isTabVisible(int index) const

如果位置 index 的标签可见，则返回 true；否则返回 false。

[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)

重新实现了： QWidget::keyPressEvent(QKeyEvent *event).

[override virtual] QSize QTabBar::minimumSizeHint() const

重新实现了属性访问函数：QWidget::minimumSizeHint.

[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const

返回位置 index 的标签的最小大小提示。

[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)

重新实现了： QWidget::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)

重新实现了： QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)

重新实现了： QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)

重新实现了： QWidget::mouseReleaseEvent(QMouseEvent *event).

void QTabBar::moveTab(int from, int to)

将索引位置 from 的项目移动到索引位置 to。

另请参阅tabMoved() 和 tabLayoutChange().

[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)

重新实现了： QWidget::paintEvent(QPaintEvent *event).

void QTabBar::removeTab(int index)

移除位置 index 的标签。

另请参阅SelectionBehavior.

[重写虚受保护] void QTabBar::resizeEvent(QResizeEvent *)

重新实现： QWidget::resizeEvent(QResizeEvent *event).

void QTabBar::setAccessibleTabName(int index, const QString &name)

设置位于 index 位置的选项卡的访问名称为 name。

另请参阅accessibleTabName().

void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)

设置 widget 在 index 位置的选项卡上。根据 position 将将其放置在左侧或右侧。

将 position 中的之前设置的任何部件隐藏。将 widget 设置为 nullptr 将隐藏当前 position 位置的部件。

选项卡栏将获得该部件的所有权，因此在此设置的任何部件都将在它销毁时由选项卡栏删除，除非在设置其他部件（或 nullptr）之后单独将部件重新父化。

另请参阅tabButton() 和 tabsClosable().

void QTabBar::setTabData(int index, const QVariant &data)

将位于 index 位置的分区的数据设置为 data。

另请参阅tabData().

void QTabBar::setTabEnabled(int index, bool enabled)

如果 enabled 为 true，则位于 index 位置的选项卡将启用；否则，位于 index 位置的项将禁用。

另请参阅isTabEnabled().

void QTabBar::setTabIcon(int index, const QIcon &icon)

将 index 位置的分区的图标设置为 icon。

另请参阅tabIcon().

void QTabBar::setTabText(int index, const QString &text)

将位于 index 位置的分区的文本设置为 text。

另请参阅tabText().

void QTabBar::setTabTextColor(int index, const QColor &color)

将带有给定 index 的选项卡中文本的颜色设置为指定的 color。

如果指定了无效的颜色，则选项卡将使用 QTabBar 的前景角色。

另请参阅tabTextColor().

void QTabBar::setTabToolTip(int index, const QString &tip)

设置位置为 index 的选项卡的工具提示为 tip。

另请参阅 tabToolTip()。

void QTabBar::setTabVisible(int index, bool visible)

如果 visible 为 true，则使位置为 index 的选项卡可见，否则将其隐藏。

另请参阅 isTabVisible()。

void QTabBar::setTabWhatsThis(int index, const QString &text)

将位置为 index 的选项卡的“这是什么”帮助文本设置为 text。

另请参阅 tabWhatsThis()。

[覆盖虚保护] void QTabBar::showEvent(QShowEvent *)

重实现: QWidget::showEvent(QShowEvent *event)。

[覆盖虚] QSize QTabBar::sizeHint() const

重实现了获取属性的帮助函数: QWidget::sizeHint。

int QTabBar::tabAt(const QPoint &position) const

返回覆盖 position 的选项卡的索引，如果没有任何选项卡覆盖 position，则返回 -1；

[信号] void QTabBar::tabBarClicked(int index)

当用户点击索引为 index 的选项卡时，会发出此信号。

index 是被点击的选项卡的索引，如果没有选项卡位于光标下，则返回 -1。

[信号] void QTabBar::tabBarDoubleClicked(int index)

当用户在 index 选项卡上双击时，会发出此信号。

index 指的是被点击的选项卡，如果没有选项卡位于光标下，则返回 -1。

QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const

返回设置索引为 index 和 position 的选项卡的控件，如果没有设置，则返回 nullptr。

另请参阅 setTabButton()。

[信号] void QTabBar::tabCloseRequested(int index)

当点击选项卡上的关闭按钮时，会发出此信号。 index 是应删除的索引。

另请参阅 setTabsClosable()。

QVariant QTabBar::tabData(int index) const

返回位置 index 上的标签数据，如果 index 超出范围，则返回空变体。

另请参阅 setTabData。

QIcon QTabBar::tabIcon(int index) const

返回位置 index 上标签的图标，如果 index 超出范围，则返回空图标。

另请参阅 setTabIcon。

[虚受保护] void QTabBar::tabInserted(int index)

当在位置 index 添加或插入新标签后，调用此虚函数。

另请参阅 tabRemoved。

[虚受保护] void QTabBar::tabLayoutChange()

每当标签布局发生变化时，会调用此虚函数。

另请参阅 tabRect。

[信号] void QTabBar::tabMoved(int from, int to)

当设备索引为 from 的标签移至索引为 to 的位置时，会发出此信号。

注意：QTabWidget 在发出来自其标签栏的此信号时会自动移动页面。

另请参阅 moveTab。

QRect QTabBar::tabRect(int index) const

返回位置 index 上标签的视觉矩形，如果 index 隐藏或超出范围，则返回空矩形。

[虚受保护] void QTabBar::tabRemoved(int index)

从位置 index 移除标签后，调用此虚函数。

另请参阅 tabInserted。

[虚受保护] QSize QTabBar::tabSizeHint(int index) const

返回位置 index 上标签的大小提示。

QString QTabBar::tabText(int index) const

返回位置 index 上标签的文本，如果 index 超出范围，则返回空字符串。

另请参阅 setTabText。

QColor QTabBar::tabTextColor(int index) const

返回给定 index 的标签的文本颜色，如果 index 超出范围，则返回无效颜色。

另请参阅 setTabTextColor。

QString QTabBar::tabToolTip(int index) const

返回位置 index 的标签工具提示，如果 index 超出范围则返回空字符串。

另请参阅 setTabToolTip。

QString QTabBar::tabWhatsThis(int index) const

返回位置 index 的标签“这是什么”帮助文本，如果 index 超出范围则返回空字符串。

另请参阅 setTabWhatsThis。

[重写虚受保护] void QTabBar::timerEvent(QTimerEvent *event)

重实现: QObject::timerEvent(QTimerEvent *event)。

[重写虚受保护] void QTabBar::wheelEvent(QWheelEvent *event)

重实现: QWidget::wheelEvent(QWheelEvent *event)。