QTabBar Class

成员函数文档

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

使用给定的parent 创建一个新的标签栏。

[virtual noexcept] QTabBar::~QTabBar()

删除标签栏。

QString QTabBar::accessibleTabName(int index) const

返回位于位置index 的选项卡的 accessibleName，如果index 超出范围，则返回空字符串。

另请参阅 setAccessibleTabName()。

int QTabBar::addTab(const QString &text)

添加一个标题为“text ”的新标签页。返回该新标签页的索引号。

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

添加一个新标签页，其图标为icon ，文本为text 。返回新标签页的索引。

[override virtual protected] void QTabBar::changeEvent(QEvent *event)

重写了：QWidget::changeEvent(QEvent *event)。

[signal] void QTabBar::currentChanged(int index)

当标签栏的当前标签页发生变化时，会触发此信号。新的当前标签页具有给定的index ，如果没有新的当前标签页，则为-1（例如，当QTabBar 中没有标签页时）

[override virtual protected] bool QTabBar::event(QEvent *event)

重写了：QWidget::event(QEvent *event)。

[override virtual protected] void QTabBar::hideEvent(QHideEvent *)

重写了：QWidget::hideEvent(QHideEvent *event)。

[virtual protected] 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 。

[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)

重写了：QWidget::resizeEvent(QResizeEvent *event)。

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

将位置为index 的选项卡的 accessibleName 设置为name 。

另请参阅 accessibleTabName()。

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

在“index ”选项卡上设置widget 。该控件将根据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 为真，则位置为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 为真，则将位于位置index 的选项卡显示出来；否则将其隐藏。

另请参阅 isTabVisible()。

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

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

另请参阅 tabWhatsThis()。

[override virtual protected] void QTabBar::showEvent(QShowEvent *)

重写了：QWidget::showEvent(QShowEvent *event)。

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

重新实现了属性QWidget::sizeHint 的访问函数。

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

返回覆盖position 的标签页的索引，如果没有标签页覆盖position ，则返回 -1；

[signal] void QTabBar::tabBarClicked(int index)

当用户单击index 上的一个标签页时，会触发此信号。

index 表示被点击的标签页的索引；如果光标未位于任何标签页上，则返回 -1。

[signal] void QTabBar::tabBarDoubleClicked(int index)

当用户双击index 上的标签页时，会触发此信号。

index 表示被点击的标签页；如果光标下方没有标签页，则返回 -1。

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

返回已设置标签页的控件集index ，若未设置标签页，则返回position 或nullptr 。

另请参阅 setTabButton()。

[signal] void QTabBar::tabCloseRequested(int index)

当点击标签页上的关闭按钮时，会触发此信号。index 表示应被移除的索引。

另请参阅 setTabsClosable()。

QVariant QTabBar::tabData(int index) const

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

另请参阅 setTabData()。

QIcon QTabBar::tabIcon(int index) const

返回位于位置 `index` 的选项卡图标；如果 `index ` 超出范围，则返回空图标。

另请参阅 setTabIcon()。

[virtual protected] void QTabBar::tabInserted(int index)

在index 位置添加或插入新标签页后，将调用此虚拟处理程序。

另请参阅 tabRemoved()。

[virtual protected] void QTabBar::tabLayoutChange()

每当标签页布局发生变化时，都会调用此虚拟处理程序。

另请参阅 tabRect()。

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

当标签页将索引位置为from 的标签页移动到索引位置为to 时，会发出此信号。

注意：当该信号从其标签栏发出时，QTabWidget 会自动移动页面。

另请参阅 moveTab()。

QRect QTabBar::tabRect(int index) const

返回位于位置index 处的选项卡的视觉矩形；如果index 被隐藏或超出范围，则返回空矩形。

[virtual protected] void QTabBar::tabRemoved(int index)

当从位置index 移除一个标签页后，将调用此虚拟处理程序。

另请参阅 tabInserted()。

[virtual protected] 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()。

[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)

重写了：QObject::timerEvent(QTimerEvent *event)。

[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)

重写了：QWidget::wheelEvent(QWheelEvent *event)。