QT开发——QT单元组件

Posted 2020-08-17

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<QListWidgetItem *>QListWidget：：findItems（const QString &text，Qt：：MatchFlags flags）const

查找匹配字符串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<QListWidgetItem*> QListWidget：：selectedItems（）const

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

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 <QtGui/QApplication>
#include <QWidget>
#include <QVBoxLayout>
#include <QListWidget>
#include <QListWidgetItem>
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<QTreeWidgetItem*> &items）

把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<QTreeWidgetItem*> QTreeWidget：：findItems（const QString &text，Qt：：MatchFlags flags，int column = 0）const

查找匹配字符串的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<QTreeWidgetItem *> QTreeWidget：：selectItems（）const

返回所有选中状态的项目

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 <QtGui/QApplication>
#include <QWidget>
#include <QTreeWidgetItem>
#include <QTreeWidget>
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<QTableWidgetItem *> QTableWidget：：findItems（const QString &text，Qt：：MatchFlags flags）const

查找匹配字符串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<QTableWidgetItem *> QTableWidget：：selectedItems（）

返回所有选中状态的项目

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 <QtGui/QApplication>
#include <QTableWidget>
#include <QTableWidgetItem>
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();
}

本文出自 “生命不息，奋斗不止” 博客，谢绝转载！