QTabBar Class

成员函数文档

[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 。返回新标签页的索引。

[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 都会被隐藏。将widget 设置为nullptr 将隐藏当前 widgetposition 。

标签栏将拥有该 widget 的所有权，因此当标签栏被销毁时，在此设置的所有 widget 都将被标签栏删除，除非您在设置其他 widget（或nullptr ）后单独重新指定该 widget。

另请参阅 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() 。

[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 标签的 widget，如果未设置，则返回nullptr 。

另请参阅 setTabButton().

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

[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 位置的标签页的帮助文本 What's This，如果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).