QTabWidget类

成员函数文档

[显式] QTabWidget::QTabWidget(QWidget *parent = nullptr)

以parent作为父级构建一个选项卡窗口。

[虚拟 noexcept] QTabWidget::~QTabWidget()

销毁选项卡窗口。

int QTabWidget::addTab(QWidget *page, const QString &label)

将带有指定 page 和 label 的标签添加到标签窗口，并返回标签在标签栏中的索引。将 page 的所有权传递给 QTabWidget。

如果标签的 label 包含一个和号（&），则和号后面的字母被用作标签的快捷键，例如，如果标签是 "Bro&wse"，则 Alt+W 成为快捷键，这将移动焦点到该标签。

另见：insertTab（）。

int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label)

这是一个重载函数。

将指定 page、icon 和 label 的标签添加到标签窗口，并返回标签在标签栏中的索引。将 page 的所有权传递给 QTabWidget。

此函数与 addTab() 相同，但具有额外的 icon。

[覆盖虚拟受保护] void QTabWidget::changeEvent(QEvent *ev)

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

void QTabWidget::clear()

删除所有页面，但不删除它们。调用此函数相当于调用 removeTab()，直到标签窗口为空。

QWidget *QTabWidget::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

返回在标签窗口 corner 显示的小部件或 nullptr。

另见：setCornerWidget。

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

每当当前页面索引更改时都会发出此信号。参数是新当前页面 index 位置，或者如果没有新的（例如，如果没有小部件在 QTabWidget 中），则为 -1

另见：currentWidget() 和 currentIndex。

QWidget *QTabWidget::currentWidget() const

返回由标签对话框当前显示的页面指针。标签对话框会尽力确保该值永远不会是0（但如果足够努力，它可以是）。

另请参阅 currentIndex() 和 setCurrentWidget().

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

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

[覆盖虚拟] bool QTabWidget::hasHeightForWidth() const

重实现了: QWidget::hasHeightForWidth() const.

[覆盖虚拟] int QTabWidget::heightForWidth(int width) const

重实现了: QWidget::heightForWidth(int w) const.

int QTabWidget::indexOf(const QWidget *w) const

返回由小部件 w 占用的页面的索引位置，如果找不到该小部件，返回-1。

[虚拟保护] void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const

使用此 QTabWidget 的值初始化 option。此方法对于子类很有用，当它们需要 QStyleOptionTabWidgetFrame，但又不想自己填写所有信息时。

另请参阅 QStyleOption::initFrom() 和 QTabBar::initStyleOption().

int QTabWidget::insertTab(int index, QWidget *page, const QString &label)

在指定的 index 处的标签视图中插入带有给定 label 和 page 的标签，并返回插入到标签栏中的标签的索引。将 page 的所有权传递给 QTabWidget。

标签中的标签会显示出来，其外观可能因标签视图的配置而异。

如果标签的 label 包含一个和号（&），则和号后面的字母被用作标签的快捷键，例如，如果标签是 "Bro&wse"，则 Alt+W 成为快捷键，这将移动焦点到该标签。

如果 index 超出范围，则标签会被简单追加。否则，它会被插入到指定的位置。

如果在调用此函数之前 QTabWidget 是空的，则新页面成为当前页面。在小于或等于当前索引的位置插入新标签将增加当前索引，但保持当前页面。

另请参阅 addTab().

int QTabWidget::insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)

这是一个重载函数。

将带有指定 label、page 和 icon 的标签插入到指定 index 处的标签控件中，并返回插入标签在标签栏中的索引。将 page 的所有权传递给 QTabWidget。

此函数与 insertTab() 相同，但还包含额外的 icon。

bool QTabWidget::isTabEnabled(int index) const

如果位置为 index 的页面被启用，则返回 true；否则返回 false。

另见 setTabEnabled() 和 QWidget::isEnabled。

bool QTabWidget::isTabVisible(int index) const

如果位置为 index 的页面是可见的，则返回 true；否则返回 false。

另见 setTabVisible。

[覆盖虚保护] void QTabWidget::keyPressEvent(QKeyEvent *e)

重写：QWidget::keyPressEvent(QKeyEvent *event).

[覆盖虚] QSize QTabWidget::minimumSizeHint() const

重写属性访问函数：QWidget::minimumSizeHint。

返回适合标签控件的合适最小尺寸。

[覆盖虚保护] void QTabWidget::paintEvent(QPaintEvent *event)

重写：QWidget::paintEvent(QPaintEvent *event).

在响应绘制 event 时绘制标签控件的标签栏。

void QTabWidget::removeTab(int index)

从该堆栈中移除位置为 index 的标签。页面控件本身不会被删除。

另见 addTab() 和 insertTab。

[覆盖虚保护] void QTabWidget::resizeEvent(QResizeEvent *e)

重写：QWidget::resizeEvent(QResizeEvent *event).

void QTabWidget::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

将指定的 widget 设置为在标签控件指定的 corner 中显示。小部件的几何形状取决于小部件的 sizeHint() 和 style。

将仅使用 corner 的水平元素。

传递 nullptr 在角落中不显示任何小部件。

隐藏任何先前设置的角落小部件。

此处设置的所有小部件将在标签小部件被销毁时被删除，除非您在设置某些其他角落小部件（或nullptr）后单独将小部件重置父。

注意：角落小部件是为North和South标签位置设计的；其他方向已知无法正常工作。

另请参阅cornerWidget()和setTabPosition。

[slot] void QTabWidget::setCurrentWidget(QWidget *widget)

使widget成为当前小部件。使用的widget必须是此标签小部件中的页面。

另请参阅addTab()、setCurrentIndex()和currentWidget。

[受保护的] void QTabWidget::setTabBar(QTabBar *tb)

用标签栏tb替换对话框的QTabBar标题。请注意，这必须在添加任何标签之前调用，否则行为是未定义的。

另请参阅tabBar。

void QTabWidget::setTabEnabled(int index, bool enable)

如果enable为true，则位置为index的页面将启用；否则位置为index的页面将禁用。页面的标签按适当方式重绘。

QTabWidget使用内部QWidget::setEnabled()，而不是保持单独的标志。

请注意，即使禁用标签/页面也可能可见。如果页面已经可见，QTabWidget不会隐藏它；如果所有页面都禁用，QTabWidget将显示其中一个。

另请参阅isTabEnabled()和QWidget::setEnabled。

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

为位置为index的标签设置icon。

另请参阅tabIcon。

void QTabWidget::setTabText(int index, const QString &label)

为位置为index的页面的标签定义一个新label。

如果提供的文本包含一个和字符('&')，将自动为其创建一个快捷方式。紧随'&'之后的字符将用作快捷键。任何以前的快捷方式都将被覆盖，或者如果没有定义文本中的快捷方式，将清除。

另请参阅tabText。

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

将位置为index的页面的标签工具提示设置为tip。

另请参阅tabToolTip。

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

如果 visible 为真，则在 index 位置的页面是可见的；否则，在 index 位置的页面是隐藏的。页面的选项卡将相应地重新绘制。

另请参阅isTabVisible()。

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

将 index 位置的页面的帮助文本设置为 text。

另请参阅tabWhatsThis()。

[覆盖虚拟受保护] void QTabWidget::showEvent(QShowEvent *)

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

[覆盖虚拟] QSize QTabWidget::sizeHint() const

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

QTabBar *QTabWidget::tabBar() const

返回当前的 QTabBar。

另请参阅setTabBar()。

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

当用户在 index 位置的选项卡上单击时，发出此信号。

index 指的是被单击的选项卡，或者如果光标下没有选项卡，则为 -1。

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

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

index 是被单击的选项卡的索引，或者如果光标下没有选项卡，则为 -1。

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

当在一个选项卡的关闭按钮上单击时，发出此信号。 index 是应该被移除的索引。

另请参阅setTabsClosable()。

QIcon QTabWidget::tabIcon(int index) const

返回 index 位置页面上的选项卡的图标。

另请参阅setTabIcon()。

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

在向 index 位置添加或插入新选项卡后，调用此虚拟处理程序。

另请参阅tabRemoved()。

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

从 index 位置移除选项卡后，调用此虚拟处理程序。

另请参阅 tabInserted()。

QString QTabWidget::tabText(int index) const

返回位于页面位置 index 的标签文本。

另请参阅 setTabText()。

QString QTabWidget::tabToolTip(int index) const

返回位于位置 index 的页面的标签工具提示，如果没有设置工具提示，则返回空字符串。

另请参阅 setTabToolTip()。

QString QTabWidget::tabWhatsThis(int index) const

返回位于位置 index 的页面的“这是什么”帮助文本，如果没有设置帮助文本，则返回空字符串。

另请参阅 setTabWhatsThis()。

QWidget *QTabWidget::widget(int index) const

返回位置位于 index 的标签页面，如果 index 超出范围，则返回 nullptr。