QT开发（九）——QT单元组件
QT有三种单元组件，分别为列表单元组件QListWidget、树形单元组件QTreeWidget、表格单元组件QTableWidget。
一、QListWidget列表单元
1、QListWidget组件简介
QListWidget列表单元组件继承自QListView，是基于单元的列表组件。QListWidget可以显示一个清单，清单中的每个项目是QListWidgetItem的一个实例，每个项目可以通过QListWidgetItem来操作。可以通过QListWidgetItem来设置每个项目的图像与文字。
2、QListWidget组件属性
QListWidget列表单元组件属性设置选项：
A、name：组件对应源代码内的名称
B、font：设置表格内部的字体
C、count：保持项目的数目
D、currentRow：保持当前项目的行
E、sortingEnabled：是否对item排序
3、QListWidget组件常用成员函数
QListWidget：：QListWidget（QWidget *parent = 0）
构造父对象为parent的ListWidget
void QListWidget：：addItem（QListWidgetItem *item）
添加项目item
void QListWidget：：addItem（const QString &label）
添加一个新的项目，在新添加的项目中添加label标签
void QListWidget：：addItems（const QStringList &labels）
添加一列项目
void QListWidget：：clear（）[slot]
清除该ListWidget中的所有项目
QListWidgetItem *QListWidget：：currentItem（）const
返回当前活动的项目
void QListWidget：：editItem（QListWidgetItem *item）
如果项目item是可编辑的，开始编辑项目item
QList
查找匹配字符串text的项目，并返回查找结果
void QListWidget：：insertItem（int row，QListWidgetItem * item）
在行row处插入项目item
void QListWidget：：insertItem（int row，const QString &label）
这是一个重载函数，功能同（9），在行row处插入标签为label的新项目
void QListWidget：：insertItem（int row，const QStringList &labels）
在行row处插入一列项目
QListWidgetItem *QListWidget：：item（int row）const
返回行row处的项目，如果行row处没有项目则返回0
QListWidgetItem *QListWidget：：itemAt（const QPoint &p）const
返回点p处的项目
QListWidgetItem *QListWidget：：itemAt（int row，int y）const
返回坐标（x，y）处的项目
QWidget *QListWidget：：itemWidget（QListWidgetItem *item）const
返回项目item处显示的控件
QListWidgetItem *QListWidget：：takeItem（int row）
移除行row处的项目，并返回项目控件
void QListWidget：：removeItemWidget（QListWidgetItem *item）
移除项目item处的控件
int QListWidget：：row（const QListWidgetItem *item）cosnt
返回项目item所在的行
QList
返回所有被选中的项目的控件
void QListWidget：：setcurrentItem（QListWidgetItem *item）
设置项目item为当前项目
void QListWidget：：setItemWidget（QListWidgetItem *item，QWidget *widget）
设置控件widget为项目item的显示控件
void QListWidget：：setItemWidget（QListWidgetItem *item，QWidget *widget）
void QListWidget：：sortItems（Qt：：SortOrder order = Qt：：AscendingOrder）
把项目按照order进行排序
4、QListWidget实例
#include#include #include #include #include int main(int argc, char *argv[]) { QApplication a(argc, argv); QWidget* widget = new QWidget; QListWidget* listWidget = new QListWidget(widget); QVBoxLayout* layout = new QVBoxLayout; QListWidgetItem* lst1 = new QListWidgetItem("data", listWidget); QListWidgetItem* lst2 = new QListWidgetItem("decision", listWidget); QListWidgetItem* lst3 = new QListWidgetItem("document", listWidget); QListWidgetItem* lst4 = new QListWidgetItem("process", listWidget); QListWidgetItem* lst5 = new QListWidgetItem("printer", listWidget); listWidget->insertItem(1, lst1); listWidget->insertItem(2, lst2); listWidget->insertItem(3, lst3); listWidget->insertItem(4, lst4); listWidget->insertItem(5, lst5); listWidget->show(); layout->addWidget(listWidget); widget->setLayout(layout); widget->show(); return a.exec(); }
二、QTreeWidget树形单元
1、QTreeWidget组件简介
QTreeWidget树形单元组件继承自QTreeView类，是树形视图使用预定义的模型，也是基于模型/视图结构的组件，为方便开发人员使用树形视图，可以用来来创建简单地树形结构列表。通过QTreeWidget类和QTreeWidgetItem类实现树形结构，QTreeWidgetItem类实现结点的添加。
2、QTreeWidget组件属性
QTreeWidget组件属性设置选项：
A、name：组件对应源代码内的名称
B、font：设置表格内部的字体
C、columnCount：保存TreeWidget的列数
3、QTreeWidget组件常用成员函数
QTreeWidget：：QTreeWidget（QWidget *parent = 0）
构造一个父对象为parent的TreeWidget
void QTreeWidget：：addTopLevelItem（QTreeWidgetItem * item）
在QTreeWidget组件中追加item为顶级项目
void QTreeWidget：：addTopLevelItems（const QList
把items中的项目作为顶级项目追加到该TreeWidget中
void QTreeWidget：：clear（）[slot]
清除TreeWidget中的所有项目
void QTreeWidget：：collapseItem（const QTreeWidgetItem *item）[slot]
折叠项目item
int QTreeWidget：：currentColumn（）const
返回当前活动列
QTreeWidgetItem *QTreeWidget：：currentItem（）const
返回当前活动项目
void QTreeWidget：：editItem（QTreeWidgetItem *item，int column = 0）
如果列column的item是可编辑的，开始编辑
void QTreeWidget：：expandItem（const QTreeWidgetItem *item）[slot]
展开项目
QList
查找匹配字符串的text的项目，并返回查找结果
QTreeWidgetItem *QTreeWidget：：headerItem（）const
返回头项目
QModelIndex QTreeWidget：：indexFromItem（QTreeWidgetItem *item，int column = 0）const [protected]
返回列column的项目item模型索引
int QTreeWidget：：indexOfTopLevelItem（QTreeWidgetItem *item）const
返回顶级项目item的模型索引，如果item不存在返回-1
int QTreeWidget：：sortColumn（）const
返回排序的列
void QTreeWidget：：sortItems（int column，Qt：：SortOrder order）
对列column的项目按照order进行排序
QTreeWidgetItem *QTreeWidget：：itemAbove（const QTreeWidgetItem *item）const
返回item的上一个项目
QTreeWidgetItem *QTreeWidget：：itemAt（const QPoint &p） const
返回点p处的项目
QTreeWidgetItem *QTreeWidget：：itemAt（int x，int y）const
返回坐标（x，y）处的项目
void QTreeWidget：：setItemWidget（QTreeWidgetItem *item，int column，QWidget *widget）
设置控件widget为项目item的显示控件，项目item在列column中
QTreeWidgetItem *QTreeWidget：：itemBelow（const QTreeWidgetItem *item）const
返回item的下一个项目
QWidget *QTreeWidget：：itemWidget（QTreeWidgetItem *item，int column）const
返回列column中的项目item显示控件
void QTreeWidget：：removeItemWidget（QTreeWidgetItem *item，int column）
移除列column中的项目item的显示控件
QList
返回所有选中状态的项目
void QTreeWidget：：setCurrentItem（QTreeWidgetItem *item）
设置item为当前项目
void QTreeWidget：：setCurrentItem（QTreeWidgetItem *item，int column）
设置列column的项目item为当前项目
void QTreeWidget；：setHeaderItem（QTreeWidgetItem *item）
设置item为该TreeWidget的头项目
void QTreeWidget：：setHeaderLabel（const QString &label）
设置label为头标题
QTreeWidgetItem *QTreeWidget：：topLevelItem（int index）cosnt
返回所有index的顶级项目
4、QTreeWidget实例
#include#include #include #include int main(int argc, char *argv[]) { QApplication a(argc, argv); QWidget *widget = new QWidget; QTreeWidget *tree = new QTreeWidget(widget); tree->setColumnCount(1); //设置列数 tree->setHeaderLabel(QString::fromLocal8Bit("图像选择")); //设置头的标题 QTreeWidgetItem *Item1 = new QTreeWidgetItem(tree,QStringList(QString::fromLocal8Bit("图像1"))); QTreeWidgetItem *Item11 = new QTreeWidgetItem(Item1,QStringList(QString::fromLocal8Bit("Band1"))); //子节点1 Item1->addChild(Item11); //添加子节点 QTreeWidgetItem *Item2 = new QTreeWidgetItem(tree,QStringList(QString::fromLocal8Bit("图像2"))); QTreeWidgetItem *Item21 = new QTreeWidgetItem(Item2,QStringList(QString::fromLocal8Bit("Band1"))); //子节点1 QTreeWidgetItem *Item22 = new QTreeWidgetItem(Item2,QStringList(QString::fromLocal8Bit("Band2"))); //子节点2 Item2->addChild(Item21); //添加子节点 Item2->addChild(Item22); tree->expandAll(); //结点全部展开 widget->show(); return a.exec(); }
三、QTableWidget表格单元
1、QTableWidget组件简介
QTableWidget表格单元组件继承自QTableView，QTableView可以使用自定义的数据模型来显示内容，而QTableWidget则只能使用标准的数据模型，并且其单元格数据是QTableWidgetItem的对象来实现的，QTableWidgetItem用来表示表格中的一个单元格，整个表格都需要用逐个单元格构建起来。
2、QTableWidget组件属性
QTableWidget组件属性设置选项：
A、name：组件对应源代码内的名称
B、font：设置表格对应的字体
C、columnCount：保存列的数目
D、rowCount：保存行的数目
3、QTableWidget组件常用成员函数
QTableWidget：：QTableWidget（QWidget * parent = 0）
构造一个父对象为parent的TableWidget
QTableWidget：：QTableWidget（int rows，int columns，QWidget *parent = 0）
构造一个rows行，columns列，父对象为parent的TableWidget控件
QWidget *QTableWidget：：cellWidget（int row，int column）const
返回行row，列column的单元格处的控件
void QTableWidget：：clear（）[slot]
删除该TreeWidget中的所有项目
void QTableWidget：：clearContents（）[slot]
删除该TreeWidget中除了header外的所有项目
int QTableWidget：：column（const QTableWidgetItem *item）const
返回项目item所在的列
int QTableWidget：：currentColumn（）const
返回当前活动的列
QTableWidgetItem *QTableWidget：：currentItem（）const
返回当前活动的项目
int QTableWidget：：currentRow（）const
返回当前活动的行
void QTableWidget：：editItem（QTableWidgetItem *item）
如果item是可编辑的，开始编辑item
QList
查找匹配字符串text的项目，并返回查找结果
void QTableWidget：：insertColumn（int column）[slot]
在列column处插入新列
void QTableWidget：：insertRow（int row）[slot]
在行row处插入新行
QTableWidgetItem *QTableWidget：：item（int row，int column）const
返回行row、列column处的项目
QTableWidgetItem *QTableWidget：：itemAt（const QPoint &point）const
返回点point处的项目
QTableWidgetItem *QTableWidget：：itemAt（int ax，int ay）const
返回坐标（ax，ay）处的项目
void QTableWidget：：removeCellWidget（int row，int column）
移除行row、列column单元格处的显示控件
void QTableWidget：：removeColumn（int column）[slot]
移除列column
void QTableWidget：：removerRow（int row）[slot]
移除行row
int QTableWidget：：row（const QTableWidgetItem *item）cosnt
返回item的行
QList
返回所有选中状态的项目
void QTableWidget：：setCellWidget（int row，int column，QWidget *widget）
设置行row、列column处的显示控件为widget。
void QTableWidget：：setCurrentCell（int row，int column）
设置行row，列column处的单元格为当前活动单元格
void QTableWidget：：setCurrentItem（QTableWidgetItem *item）
设置项目item为当前活动项目
void QTableWidget：：setHorizontalHeaderItem（int column，QTableWidgetItem *item）
设置项目item为列column的水平头项目，功能同setVerticalHeaderItem（）
void QTableWidget：：setHorizontalHeaderLabels（const QStringList *labels）
设置水平标题为labels，功能同setVerticalHeaderLabels（）
void QTableWidget：：setItem（int row，int column，QTableWidgetItem *item）
设置行row、列column的单元格的项目为item
void QTableWidget：：sortItems（int column，Qt：：SortOrder order = Qt：：AscendingOrder）
对列column按照order进行排序
QTableWidgetItem *QTableWidget：：takeHorizonalHeaderItem（int column）
移除列column的水平头项目，功能同takeVerticalHeaderItem（）
QTableWidgetItem *QTableWidget：：takeItem（int row，int column）
移除行row、列column单元格处的项目
QTableWidgetItem *QTableWidget：：verticalHeaderItem（int row）const
返回行row的垂直头项目
4、QTableWidget实例
#include#include #include int main(int argc, char *argv[]) { QApplication a(argc, argv); QTableWidget *tablewidget = new QTableWidget(10,5); tablewidget->resize(350, 200); //设置表格 QStringList header; header<<"Month"<<"Description"; tablewidget->setHorizontalHeaderLabels(header); tablewidget->setItem(0,0,new QTableWidgetItem("Jan")); tablewidget->setItem(1,0,new QTableWidgetItem("Feb")); tablewidget->setItem(2,0,new QTableWidgetItem("Mar")); tablewidget->setItem(0,1,new QTableWidgetItem("Jan's month")); tablewidget->setItem(1,1,new QTableWidgetItem("Feb's month")); tablewidget->setItem(2,1,new QTableWidgetItem("Mar's month")); tablewidget->show(); return a.exec(); }