QT：控件精讲（三）单元组件 Item Widgets

    Qt Creator有3种Item Widgets。如下图：

    Item Widgets介绍

    控件类     控件名     中文名
    QListWidget     List Widget     列表单元控件
    QTreeWidget     Tree Widget     树形单元控件
    QTableWidget     Table Widget     表格单元控件

    一、ListWidget控件
    1.控件位置：Item Widget->ListWidget
    2.控件介绍：ListWidget继承自QListView类，基于Item的列表控件。
    3.控件属性设置选项：

        （1）name：该控件对应源代码内的名称
        （2）font：设置该表格内部的字体
        （3）count：保持项目的数目
        （4）currentRow：保持当前项目的行
        （5）sortingEnabled：是否对item排序

    4.常用成员函数：

        （1）QListWidget：：QListWidget（QWidget *parent = 0）

        构造父对象为parent的ListWidget

        （2）void QListWidget：：addItem（QListWidgetItem *item）

        添加项目item

        （3）void QListWidget：：addItem（const QString &label）

        添加一个新的项目，在新添加的项目中添加label标签

        （4）void QListWidget：：addItems（const QStringList &labels）

        添加一列项目

        （5）void QListWidget：：clear（）[slot]

        清除该ListWidget中的所有项目

        （6）QListWidgetItem *QListWidget：：currentItem（）const

        返回当前活动的项目

        （7）void QListWidget：：editItem（QListWidgetItem *item）

        如果项目item是可编辑的，开始编辑项目item

        （8）QListQListWidget：：findItems（const QString &text，Qt：：MatchFlags flags）const

        查找匹配字符串text的项目，并返回查找结果

        （9）void QListWidget：：insertItem（int row，QListWidgetItem * item）

        在行row处插入项目item

        （10）void QListWidget：：insertItem（int row，const QString &label）

        这是一个重载函数，功能同（9），在行row处插入标签为label的新项目

        （11）void QListWidget：：insertItem（int row，const QStringList &labels）

        在行row处插入一列项目

        （12）QListWidgetItem *QListWidget：：item（int row）const

        返回行row处的项目，如果行row处没有项目则返回0

        （13）QListWidgetItem *QListWidget：：itemAt（const QPoint &p）const

        返回点p处的项目

        （14）QListWidgetItem *QListWidget：：itemAt（int row，int y）const

        返回坐标（x，y）处的项目

        （15）QWidget *QListWidget：：itemWidget（QListWidgetItem *item）const

        返回项目item处显示的控件

        （16）QListWidgetItem *QListWidget：：takeItem（int row）

        移除行row处的项目，并返回项目控件

        （17）void QListWidget：：removeItemWidget（QListWidgetItem *item）

        移除项目item处的控件

        （18）int QListWidget：：row（const QListWidgetItem *item）cosnt

        返回项目item所在的行

        （19）QList QListWidget：：selectedItems（）const

        返回所有被选中的项目的控件

        （20）void QListWidget：：setcurrentItem（QListWidgetItem *item）

        设置项目item为当前项目

        （21）void QListWidget：：setItemWidget（QListWidgetItem *item，QWidget *widget）

        设置控件widget为项目item的显示控件

        （22）void QListWidget：：setItemWidget（QListWidgetItem *item，QWidget *widget）

        （23）void QListWidget：：sortItems（Qt：：SortOrder order = Qt：：AscendingOrder）

        把项目按照order进行排序

    二、TreeWidget控件
    1.控件位置：Item Widget->TreeWidget
    2.控件介绍：树形单元控件，继承自QTreeView类，是树形视图使用预定义的模型，他也是基于模型/视图结构的控件，为方便开发人员使用树形视图，可以使用这个控件来创建简单地树形结构列表
    3.控件属性设置选项：

        （1）name：同上
        （2）font：同上
        （3）columnCount：保存该TreeWidget的列数

    4.常用成员函数

        （1）QTreeWidget：：QTreeWidget（QWidget *parent = 0）

        构造一个父对象为parent的TreeWidget

        （2）void QTreeWidget：：addTopLevelItem（QTreeWidgetItem * item）

        在该TreeWidget中追加item为顶级项目

        （3）void QTreeWidget：：addTopLevelItems（const QList &items）

        把items中的项目作为顶级项目追加到该TreeWidget中

        （4）void QTreeWidget：：clear（）[slot]

        清除该TreeWidget中的所有项目

        （5）void QTreeWidget：：collapseItem（const QTreeWidgetItem *item）[slot]

        折叠项目item

        （6）int QTreeWidget：：currentColumn（）const

        返回当前活动列

        （7）QTreeWidgetItem *QTreeWidget：：currentItem（）const

        返回当前活动项目

        （8）void QTreeWidget：：editItem（QTreeWidgetItem *item，int column = 0）

        如果列column的item是可编辑的，开始编辑

        （9）void QTreeWidget：：expandItem（const QTreeWidgetItem *item）[slot]

        展开项目

        （10）QList QTreeWidget：：findItems（const QString &text，Qt：：MatchFlags flags，int column = 0）const

        查找匹配字符串的text的项目，并返回查找结果

        （11）QTreeWidgetItem *QTreeWidget：：headerItem（）const

        返回头项目

        （12）QModelIndex QTreeWidget：：indexFromItem（QTreeWidgetItem *item，int column = 0）const [protected]

        返回列column的项目item模型索引

        （13）int QTreeWidget：：indexOfTopLevelItem（QTreeWidgetItem *item）const

        返回顶级项目item的模型索引，如果item不存在返回-1

        （14）int QTreeWidget：：sortColumn（）const
        返回排序的列

        （15）void QTreeWidget：：sortItems（int column，Qt：：SortOrder order）

        对列column的项目按照order进行排序

        （16）QTreeWidgetItem *QTreeWidget：：itemAbove（const QTreeWidgetItem *item）const

        返回item的上一个项目

        （17）QTreeWidgetItem *QTreeWidget：：itemAt（const QPoint &p） const

        返回点p处的项目

        （18）QTreeWidgetItem *QTreeWidget：：itemAt（int x，int y）const

        返回坐标（x，y）处的项目

        （19）void QTreeWidget：：setItemWidget（QTreeWidgetItem *item，int column，QWidget *widget）

        设置控件widget为项目item的显示控件，项目item在列column中

        （20）QTreeWidgetItem *QTreeWidget：：itemBelow（const QTreeWidgetItem *item）const

        返回item的下一个项目

        （21）QWidget *QTreeWidget：：itemWidget（QTreeWidgetItem *item，int column）const

        返回列column中的项目item显示控件

        （22）void QTreeWidget：：removeItemWidget（QTreeWidgetItem *item，int column）

        移除列column中的项目item的显示控件

        （23）QList QTreeWidget：：selectItems（）const

        返回所有选中状态的项目

        （24）void QTreeWidget：：setCurrentItem（QTreeWidgetItem *item）

        设置item为当前项目

        （25）void QTreeWidget：：setCurrentItem（QTreeWidgetItem *item，int column）

        设置列column的项目item为当前项目

        （26）void QTreeWidget；：setHeaderItem（QTreeWidgetItem *item）

        设置item为该TreeWidget的头项目

        （27）void QTreeWidget：：setHeaderLabel（const QString &label）

        设置label为头标题

        （28）QTreeWidgetItem *QTreeWidget：：topLevelItem（int index）cosnt

        返回所有index的顶级项目

    三、TableWidget控件
    1.控件位置：Item Widget->Table Widget
    2.控件介绍：表格单元控件
    3.控件属性设置选项：

        （1）name：同上
        （2）font：同上
        （3）columnCount：保存列的数目
        （4）rowCount：保存行的数目

        4.常用成员函数

        （1）QTableWidget：：QTableWidget（QWidget * parent = 0）

        构造一个父对象为parent的TableWidget

        （2）QTableWidget：：QTableWidget（int rows，int columns，QWidget *parent = 0）

        构造一个rows行，columns列，父对象为parent的TableWidget控件

        （3）QWidget *QTableWidget：：cellWidget（int row，int column）const

        返回行row，列column的单元格处的控件

        （4）void QTableWidget：：clear（）[slot]

        删除该TreeWidget中的所有项目

        （5）void QTableWidget：：clearContents（）[slot]

        删除该TreeWidget中除了header外的所有项目

        （6）int QTableWidget：：column（const QTableWidgetItem *item）const

        返回项目item所在的列

        （7）int QTableWidget：：currentColumn（）const

        返回当前活动的列

        （8）QTableWidgetItem *QTableWidget：：currentItem（）const

        返回当前活动的项目

        （9）int QTableWidget：：currentRow（）const

        返回当前活动的行

        （10）void QTableWidget：：editItem（QTableWidgetItem *item）

        如果item是可编辑的，开始编辑item

        （11）QList QTableWidget：：findItems（const QString &text，Qt：：MatchFlags flags）const

        查找匹配字符串text的项目，并返回查找结果

        （12）void QTableWidget：：insertColumn（int column）[slot]

        在列column处插入新列

        （13）void QTableWidget：：insertRow（int row）[slot]

        在行row处插入新行

        （14）QTableWidgetItem *QTableWidget：：item（int row，int column）const

        返回行row、列column处的项目

        （15）QTableWidgetItem *QTableWidget：：itemAt（const QPoint &point）const

        返回点point处的项目

        （16）QTableWidgetItem *QTableWidget：：itemAt（int ax，int ay）const

        返回坐标（ax，ay）处的项目

        （17）void QTableWidget：：removeCellWidget（int row，int column）

        移除行row、列column单元格处的显示控件

        （18）void QTableWidget：：removeColumn（int column）[slot]

        移除列column

        （19）void QTableWidget：：removerRow（int row）[slot]

        移除行row

        （20）int QTableWidget：：row（const QTableWidgetItem *item）cosnt

        返回item的行

        （21）QList QTableWidget：：selectedItems（）

        返回所有选中状态的项目

        （22）void QTableWidget：：setCellWidget（int row，int column，QWidget *widget）

        设置行row、列column处的显示控件为widget。

        （23）void QTableWidget：：setCurrentCell（int row，int column）

        设置行row，列column处的单元格为当前活动单元格

        （24）void QTableWidget：：setCurrentItem（QTableWidgetItem *item）

        设置项目item为当前活动项目

        （25）void QTableWidget：：setHorizontalHeaderItem（int column，QTableWidgetItem *item）

        设置项目item为列column的水平头项目，功能同setVerticalHeaderItem（）

        （26）void QTableWidget：：setHorizontalHeaderLabels（const QStringList *labels）

        设置水平标题为labels，功能同setVerticalHeaderLabels（）

        （27）void QTableWidget：：setItem（int row，int column，QTableWidgetItem *item）

        设置行row、列column的单元格的项目为item

        （28）void QTableWidget：：sortItems（int column，Qt：：SortOrder order = Qt：：AscendingOrder）

        对列column按照order进行排序

        （29）QTableWidgetItem *QTableWidget：：takeHorizonalHeaderItem（int column）

        移除列column的水平头项目，功能同takeVerticalHeaderItem（）

        （30）QTableWidgetItem *QTableWidget：：takeItem（int row，int column）

        移除行row、列column单元格处的项目

        （31）QTableWidgetItem *QTableWidget：：verticalHeaderItem（int row）const

        返回行row的垂直头项目