class QToolBox#

PySide6.QtWidgets.QToolBox类提供了一个带有标签工具项的列。《更多》…

Inheritance diagram of PySide6.QtWidgets.QToolBox

摘要#

属性#

方法#

虚拟方法#

槽函数#

信号#

注意

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

详细说明#

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

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

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

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

当当前项发生变化时，会发出 currentChanged() 信号。

另请参阅

QTabWidget

注意

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

property countᅟ: int#

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

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

访问函数
属性 currentIndex: int#

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

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

另请参阅

indexOf widget

访问函数
__init__([parent=None[, f=Qt.WindowFlags()]])#
参数：

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

addItem(widget, icon, text)#
参数：
返回类型：

int

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

addItem(widget, text)
参数：
返回类型：

int

这是一个重载函数。

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

count()#
返回类型：

int

属性 count 的获取器。

currentChanged(index)#
参数：

index – int

当当前项改变时，会发出此信号。新当前项的索引传递到 index，或者如果没有当前项则为 -1。

currentIndexᅟ 的通知信号。

currentIndex()#
返回类型：

int

另请参阅

setCurrentIndex()

currentIndexᅟ 的获取器。

currentWidget()#
返回类型：

QWidget

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

indexOf(widget)#
参数：

widget – QWidget

返回类型：

int

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

insertItem(index, widget, icon, text)#
参数：

  • index – int

  • widget – QWidget

  • icon – QIcon

  • text – str

返回类型：

int

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

insertItem(index, widget, text)
参数：

  • index – int

  • widget – QWidget

  • text – str

返回类型：

int

这是一个重载函数。

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

isItemEnabled(index)#
参数：

index – int

返回类型：

bool

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

itemIcon(index)#
参数：

index – int

返回类型：

QIcon

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

另请参阅

setItemIcon()

itemInserted(index)#
参数：

index – int

在向位置 index 添加或插入新项后，将调用此虚函数处理程序。

另请参阅

itemRemoved()

itemRemoved(index)#
参数：

index – int

在从位置 index 移除项后，将调用此虚函数处理程序。

另请参阅

itemInserted()

itemText(index)#
参数：

index – int

返回类型：

str

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

另请参阅

setItemText()

itemToolTip(index)#
参数：

index – int

返回类型：

str

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

另请参阅

setItemToolTip()

removeItem(index)#
参数：

index – int

从工具箱中移除位置 index 的项。请注意，小部件并未被删除。

setCurrentIndex(index)#
参数：

index – int

另请参阅

currentIndex()

属性 currentIndexᅟ 的设置器。

setCurrentWidget(widget)#
参数：

widget – QWidget

将 ``widget`` 设置为当前小部件。``widget`` 必须是此工具箱中的项。

setItemEnabled(index, enabled)#
参数：

  • index – int

  • enabled – bool

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

另请参阅

isItemEnabled()

setItemIcon(index, icon)#
参数：

  • index – int

  • icon – QIcon

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

另请参阅

itemIcon()

setItemText(index, text)#
参数：

  • index – int

  • text – str

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

如果提供的文本包含一个和号字符（’&’），则会自动为其创建一个快捷键。和号之后字符用作快捷键。任何先前的快捷键会被覆盖，或者如果文本中没有定义快捷键，则被清除。有关详细信息，请参阅QShortcut文档（要显示实际的和号，请使用 ‘&&’）。

另请参阅

itemText()

setItemToolTip(index, toolTip)#
参数：

  • index – int

  • toolTip – str

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

另请参阅

itemToolTip()

widget(index)#
参数：

index – int

返回类型：

QWidget

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