QToolBox 类

成员函数文档

[显式] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

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

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

销毁工具箱。

int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)

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

int QToolBox::addItem(QWidget *w, const QString &text)

这是一个重载函数。

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

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

重实现： QFrame::changeEvent(QEvent *ev).

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

当当前项变动时发出此信号。新的当前项索引通过 index 传入，如果没有当前项，则为 -1。

QWidget *QToolBox::currentWidget() const

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

参见currentIndex() 和 setCurrentWidget()。

[覆盖虚拟保护] bool QToolBox::event(QEvent *e)

重实现： QFrame::event(QEvent *e).

int QToolBox::indexOf(const QWidget *widget) const

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

int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)

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

int QToolBox::insertItem(int index, QWidget *widget, const QString &text)

这是一个重载函数。

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

bool QToolBox::isItemEnabled(int index) const

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

QIcon QToolBox::itemIcon(int index) const

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

另请参阅setItemIcon()。

[虚受保护] void QToolBox::itemInserted(int index)

在添加或插入新项目到位置 index 之后调用此虚拟处理程序。

另请参阅itemRemoved()。

[虚受保护] void QToolBox::itemRemoved(int index)

在从位置 index 删除项目后调用此虚拟处理程序。

另请参阅itemInserted()。

QString QToolBox::itemText(int index) const

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

另请参阅setItemText()。

QString QToolBox::itemToolTip(int index) const

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

另请参阅setItemToolTip()。

void QToolBox::removeItem(int index)

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

[槽函数] void QToolBox::setCurrentWidget(QWidget *widget)

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

另请参阅addItem()，setCurrentIndex()，以及 currentWidget()。

void QToolBox::setItemEnabled(int index, bool enabled)

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

另请参阅isItemEnabled()。

void QToolBox::setItemIcon(int index, const QIcon &icon)

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

另请参阅itemIcon()。

void QToolBox::setItemText(int index, const QString &text)

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

如果提供的文本中包含一个 ampersand 字符 ('&')，则会自动为其创建一个简记符。跟随 '&' 的字符将被用作快捷键。任何之前的简记符将被覆盖，如果没有定义简记符，则会被清除。有关详细信息，请参阅 QShortcut 文档（要显示实际的 ampersand，请使用 '&&'）。

另请参阅 itemText()。

void QToolBox::setItemToolTip(int index, const Qt::QString &toolTip)

将位置 index 的项的提示设置为 toolTip。

另请参阅 itemToolTip()。

[重写虚保护] void QToolBox::showEvent(QShowEvent *e)

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

QWidget *QToolBox::widget(int index) const

返回位置 index 的控件，如果没有这样的项，返回 nullptr。