PySide6.QtWidgets.QToolBox

class QToolBox

QToolBox 类提供了一列带有标签的小部件项。更多…

PySide6.QtWidgets.QToolBox 的继承图

概要

属性

方法

虚拟方法

插槽

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

工具箱是一个小部件，它显示一列上下排列的标签，当前项显示在当前标签下方。每个标签在标签列中都有一个索引位置。标签的项是一个QWidget。

每个项目都有一个itemText()，一个可选的itemIcon()，一个可选的itemToolTip()，以及一个widget()。项目的属性可以通过setItemText()、setItemIcon()和setItemToolTip()来更改。每个项目可以通过setItemEnabled()单独启用或禁用。

项目使用addItem()添加，或使用insertItem()在特定位置插入。项目总数由count()给出。项目可以通过删除操作删除，或使用removeItem()从工具箱中移除。结合使用removeItem()和insertItem()可以将项目移动到不同的位置。

当前项目小部件的索引由 currentIndex() 返回，并通过 setCurrentIndex() 设置。可以使用 indexOf() 查找特定项目的索引，而 item() 返回给定索引处的项目。

当当前项目更改时，会发出currentChanged()信号。

另请参阅

QTabWidget

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property countᅟ: int

此属性包含工具箱中的项目数量。

默认情况下，此属性的值为0。

Access functions:
property currentIndexᅟ: int

此属性保存当前项目的索引。

默认情况下，对于空工具箱，此属性的值为-1。

另请参阅

indexOf() widget()

Access functions:
__init__([parent=None[, f=Qt.WindowFlags()]])
Parameters:

使用给定的parent和标志f构造一个新的工具箱。

addItem(widget, text)
Parameters:

  • widget – QWidget

  • 文本 – str

Return type:

整数

这是一个重载函数。

在工具箱底部的新标签页中添加小部件 w。新标签页的文本设置为 text。返回新标签页的索引。

addItem(widget, icon, text)
Parameters:
Return type:

整数

在工具箱底部的新标签页中添加widget。新标签页的文本设置为text，并且iconSet显示在text的左侧。返回新标签页的索引。

count()
Return type:

整数

属性 countᅟ 的获取器。

currentChanged(index)
Parameters:

索引 – int

当当前项目更改时，会发出此信号。新当前项目的索引在index中传递，如果没有当前项目，则为-1。

属性 currentIndexᅟ 的通知信号。

currentIndex()
Return type:

整数

另请参阅

setCurrentIndex()

属性 currentIndexᅟ 的获取器。

currentWidget()
Return type:

QWidget

返回指向当前小部件的指针，如果没有这样的项，则返回None。

indexOf(widget)
Parameters:

widget – QWidget

Return type:

整数

返回widget的索引，如果该项不存在则返回-1。

insertItem(index, widget, text)
Parameters:

  • index – 整数

  • widget – QWidget

  • 文本 – str

Return type:

整数

这是一个重载函数。

将widget插入到位置index，如果index超出范围，则插入到工具箱的底部。新项目的文本设置为text。返回新项目的索引。

insertItem(index, widget, icon, text)
Parameters:

  • index – 整数

  • widget – QWidget

  • 图标 – QIcon

  • 文本 – str

Return type:

整数

在位置 index 插入 widget，如果 index 超出范围，则插入到工具箱的底部。新项目的文本设置为 text，并且 icon 显示在 text 的左侧。返回新项目的索引。

isItemEnabled(index)
Parameters:

索引 – int

Return type:

布尔

如果位置 index 处的项目已启用，则返回 true；否则返回 false。

itemIcon(index)
Parameters:

索引 – int

Return type:

QIcon

返回位置index处项目的图标，如果index超出范围，则返回空图标。

另请参阅

setItemIcon()

itemInserted(index)
Parameters:

索引 – int

当新项目在位置 index 被添加或插入后，将调用此虚拟处理程序。

另请参阅

itemRemoved()

itemRemoved(index)
Parameters:

索引 – int

当从位置 index 移除一个项目后，会调用此虚拟处理程序。

另请参阅

itemInserted()

itemText(index)
Parameters:

索引 – int

Return type:

字符串

返回位置index处的项目文本，如果index超出范围，则返回空字符串。

另请参阅

setItemText()

itemToolTip(index)
Parameters:

索引 – int

Return type:

字符串

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

另请参阅

setItemToolTip()

removeItem(index)
Parameters:

索引 – int

从工具箱中移除位置 index 处的项目。请注意，小部件不会被删除。

setCurrentIndex(index)
Parameters:

索引 – int

另请参阅

currentIndex()

属性 currentIndexᅟ 的设置器。

setCurrentWidget(widget)
Parameters:

widget – QWidget

使widget成为当前的小部件。widget必须是此工具箱中的一个项目。

setItemEnabled(index, enabled)
Parameters:

  • index – 整数

  • enabled – 布尔值

如果 enabled 为 true，则位置 index 处的项目将被启用；否则，位置 index 处的项目将被禁用。

另请参阅

isItemEnabled()

setItemIcon(index, icon)
Parameters:

  • index – 整数

  • 图标 – QIcon

将位置 index 处的项目的图标设置为 icon。

另请参阅

itemIcon()

setItemText(index, text)
Parameters:

  • index – 整数

  • 文本 – str

将位置 index 处的项目文本设置为 text。

如果提供的文本包含一个&符号（'&'），则会自动为其创建一个助记符。'&'后面的字符将用作快捷键。任何先前的助记符将被覆盖，如果文本没有定义助记符，则会被清除。详情请参阅QShortcut文档（要显示实际的&符号，请使用'&&'）。

另请参阅

itemText()

setItemToolTip(index, toolTip)
Parameters:

  • index – 整数

  • toolTip – str

将位置 index 处的项目的工具提示设置为 toolTip。

另请参阅

itemToolTip()

widget(index)
Parameters:

索引 – int

Return type:

QWidget

返回位于位置 index 的小部件，如果没有这样的项目则返回 None。