【Qt控件之QToolBox】介绍及使用

概述

QToolBox类提供了一个列式的带有选项卡的小部件条目。工具箱是一个小部件，以一个列式的选项卡显示在上方，并在当前选项卡下方显示当前的小部件条目。每个选项卡在选项卡列中有一个索引位置。选项卡的小部件条目是一个QWidget。

每个小部件条目都有一个itemText()方法获取文本，可选的itemIcon()方法获取图标，itemToolTip()方法获取工具提示，以及widget()方法获取小部件。可以使用setItemText()、setItemIcon()和setItemToolTip()方法更改小部件条目的属性。可以使用setItemEnabled()方法单独启用或禁用每个小部件条目。

使用addItem()方法添加小部件条目，或使用insertItem()方法在特定位置插入小部件条目。使用count()方法获取小部件条目的总数。可以使用delete关键字删除小部件条目，或使用removeItem()方法从工具箱中移除小部件条目。结合removeItem()和insertItem()方法，可以将小部件条目移动到不同的位置。

使用currentIndex()方法返回当前小部件条目的索引，使用setCurrentIndex()方法设置当前小部件条目的索引。可以使用indexOf()查找特定小部件条目的索引，使用item()方法返回给定索引的小部件条目。

当前小部件条目改变时，会触发currentChanged()信号。

常用函数

• addItem(QWidget *widget, const QString &text): 将一个小部件(widget)添加到工具箱中，并指定显示的文本。
• insertItem(int index, QWidget *widget, const QString &text): 在指定位置(index)插入一个小部件(widget)到工具箱中，并指定显示的文本。
• removeItem(int index): 从工具箱中移除指定位置(index)的小部件。
• count(): 返回工具箱中小部件条目的总数。
• currentIndex(): 返回当前选中的小部件条目的索引。
• setCurrentIndex(int index): 设置当前选中的小部件条目的索引。
• indexOf(QWidget *widget): 返回指定小部件(widget)在工具箱中的索引。
• item(int index): 返回指定索引位置(index)的小部件条目。
• setItemText(int index, const QString &text): 设置指定索引位置(index)的小部件条目的文本。
• setItemIcon(int index, const QIcon &icon): 设置指定索引位置(index)的小部件条目的图标。
• setItemToolTip(int index, const QString &toolTip): 设置指定索引位置(index)的小部件条目的工具提示。
• setItemEnabled(int index, bool enabled): 设置指定索引位置(index)的小部件条目是否启用。

信号：

• currentChanged(int index): 当前选中的小部件条目改变时触发该信号，返回变化后的索引。

槽：

• void setCurrentIndex(int index)：设置当前下标。
• void setCurrentWidget(QWidget *widget)：设置当前控件。</