Qt中的Model与View 4:QStandardItemModel与QTableView

目录

QStandardItemModel

API

QTableView

导航

视觉外观

坐标系统

API

样例:解析一个表格txt文件


QStandardItemModel

QStandardItemModel 可用作标准 Qt 数据类型的存储库。它是模型/视图类之一,是 Qt 模型/视图框架的一部分。它提供了一种基于项目的经典方法来处理模型。QStandardItemModel 中的项目由 QStandardItem 提供。

QStandardItemModel 实现了 QAbstractItemModel 接口,这意味着该模型可用于在任何支持该接口的视图(例如 QListView、QTableView 和 QTreeView 以及您自己的自定义视图)中提供数据。为了提高性能和灵活性,您可能希望将 QAbstractItemModel 子类化以提供对不同类型数据存储库的支持。例如,QFileSystemModel 为底层文件系统提供了模型接口。

当您想要列表或树时,通常创建一个空的 QStandardItemModel 并使用 appendRow() 将项目添加到模型,并使用 item() 访问项目。如果您的模型代表一个表,您通常会将表的尺寸传递给 QStandardItemModel 构造函数并使用 setItem() 将项目放入表中。您还可以使用 setRowCount() 和 setColumnCount() 来更改模型的尺寸。要插入项目,请使用 insertRow() 或 insertColumn(),要删除项目,请使用 removeRow() 或 removeColumn()。您可以使用 setHorizontalHeaderLabels() 和 setVerticalHeaderLabels() 设置模型的标题标签,可以使用 findItems() 在模型中搜索项目,并通过调用 sort() 对模型进行排序。调用 clear() 从模型中删除所有项目。

复制代码
QStandardItemModel model(4, 4);
for (int row = 0; row < model.rowCount(); ++row) {
    for (int column = 0; column < model.columnCount(); ++column) {
        QStandardItem *item = new QStandardItem(QString("row %0, column %1").arg(row).arg(column));
    model.setItem(row, column, item);
    }
}
复制代码
QStandardItemModel model;
QStandardItem *parentItem = model.invisibleRootItem();
for (int i = 0; i < 4; ++i) {
    QStandardItem *item = new QStandardItem(QString("item %0").arg(i));
    parentItem->appendRow(item);
    parentItem = item;
}

在视图上设置模型后,您通常希望对用户操作做出反应,例如单击某个项目。由于 QAbstractItemView 提供基于 QModelIndex 的信号和函数,因此您需要一种方法来获取与给定 QModelIndex 相对应的 QStandardItem,反之亦然。itemFromIndex() 和 indexFromItem() 提供此映射。itemFromIndex() 的典型用法包括获取视图中当前索引处的项目,以及获取与 QAbstractItemView 信号(例如 QAbstractItemView::clicked())携带的索引相对应的项目。首先,将视图的信号连接到类中的插槽:

复制代码
QTreeView *treeView = new QTreeView(this);
treeView->setModel(myStandardItemModel);
connect(treeView, &QTreeView::clicked,this, &MyWidget::clicked);

收到信号后,您可以对给定的模型索引调用 itemFromIndex() 以获取指向该项目的指针:

复制代码
void MyWidget::clicked(const QModelIndex &index)
{
    QStandardItem *item = myStandardItemModel->itemFromIndex(index);
// 对项目进行操作 ...
}

相反,当您想要调用以索引为参数的模型/视图函数时,必须获取项目的 QModelIndex。您可以使用模型的 indexFromItem() 函数获取索引,或者通过调用 QStandardItem::index() 来获取索引:

复制代码
treeView->scrollTo(item->index());

当然,您不需要使用基于项目的方法;您可以在使用模型时完全依赖 QAbstractItemModel 接口,或者根据需要使用两者的组合。

API

函数签名 详细用途
QStandardItemModel(QObject *parent = nullptr) 创建一个空的标准项模型,父对象可选。
QStandardItemModel(int rows, int columns, QObject *parent = nullptr) 创建一个指定行数和列数的标准项模型,父对象可选。
virtual ~QStandardItemModel() 析构函数,用于清理模型。
void appendColumn(const QList<QStandardItem *> &items) 在模型末尾添加一列,填充指定的 QStandardItem 列表。
void appendRow(const QList<QStandardItem *> &items) 在模型末尾添加一行,填充指定的 QStandardItem 列表。
void appendRow(QStandardItem *item) 在模型末尾添加一行,包含一个指定的 QStandardItem
QBindable<int> bindableSortRole() 返回可绑定的排序角色。
void clear() 清空模型中的所有数据。
QList<QStandardItem *> findItems(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly, int column = 0) const 根据文本查找项,返回匹配的 QStandardItem 列表。
QStandardItem * horizontalHeaderItem(int column) const 获取指定列的水平表头项。
QModelIndex indexFromItem(const QStandardItem *item) const 从指定的 QStandardItem 获取其模型索引。
void insertColumn(int column, const QList<QStandardItem *> &items) 在指定列插入新列,并填充指定的项列表。
bool insertColumn(int column, const QModelIndex &parent = QModelIndex()) 在指定列插入新列,父索引可选。
void insertRow(int row, const QList<QStandardItem *> &items) 在指定行插入新行,填充指定的项列表。
bool insertRow(int row, const QModelIndex &parent = QModelIndex()) 在指定行插入新行,父索引可选。
void insertRow(int row, QStandardItem *item) 在指定行插入新行,包含一个指定的项。
QStandardItem * invisibleRootItem() const 获取不可见的根项,用于访问整个模型树。
QStandardItem * item(int row, int column = 0) const 获取指定行列位置的项。
QStandardItem * itemFromIndex(const QModelIndex &index) const 从指定索引获取 QStandardItem
const QStandardItem * itemPrototype() const 获取项的原型,用于创建新项。
void setColumnCount(int columns) 设置列数。
void setHorizontalHeaderItem(int column, QStandardItem *item) 设置指定列的水平表头项。
void setHorizontalHeaderLabels(const QStringList &labels) 设置水平表头的标签列表。
void setItem(int row, int column, QStandardItem *item) 在指定位置设置项。
void setItem(int row, QStandardItem *item) 在指定行设置项,列默认为0。
void setItemPrototype(const QStandardItem *item) 设置项的原型。
void setItemRoleNames(const QHash<int, QByteArray> &roleNames) 设置项角色的名称映射。
void setRowCount(int rows) 设置行数。
void setSortRole(int role) 设置排序角色。
void setVerticalHeaderItem(int row, QStandardItem *item) 设置指定行的垂直表头项。
void setVerticalHeaderLabels(const QStringList &labels) 设置垂直表头的标签列表。
int sortRole() const 获取当前的排序角色。
QList<QStandardItem *> takeColumn(int column) 移除并返回指定列的项列表。
QStandardItem * takeHorizontalHeaderItem(int column) 移除并返回指定列的水平表头项。
QStandardItem * takeItem(int row, int column = 0) 移除并返回指定位置的项。
QList<QStandardItem *> takeRow(int row) 移除并返回指定行的项列表。
QStandardItem * takeVerticalHeaderItem(int row) 移除并返回指定行的垂直表头项。
QStandardItem * verticalHeaderItem(int row) const 获取指定行的垂直表头项。
函数签名 详细用途
virtual bool clearItemData(const QModelIndex &index) override 清空指定索引的项数据。
virtual int columnCount(const QModelIndex &parent = QModelIndex()) const override 获取指定父索引的列数。
virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override 获取指定索引的数据。
virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override 处理粘贴操作。
virtual Qt::ItemFlags flags(const QModelIndex &index) const override 获取指定索引的项目标志。
virtual bool hasChildren(const QModelIndex &parent = QModelIndex()) const override 判断指定父索引是否有子项。
virtual QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override 获取表头数据。
virtual QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override 获取指定行列的索引。
virtual bool insertColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override 在指定位置插入多列。
virtual bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) override 在指定位置插入多行。
virtual QMap<int, QVariant> itemData(const QModelIndex &index) const override 获取指定索引的项数据。
virtual QMimeData * mimeData(const QModelIndexList &indexes) const override 获取指定索引列表的数据。
virtual QStringList mimeTypes() const override 获取支持的 MIME 类型列表。
virtual void multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const override 获取指定索引的多项数据。
virtual QModelIndex parent(const QModelIndex &child) const override 获取指定子索引的父索引。
virtual bool removeColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override 移除多列。
virtual bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) override 移除多行。
virtual QHash<int, QByteArray> roleNames() const override 获取项角色名称的映射。
virtual int rowCount(const QModelIndex &parent = QModelIndex()) const override 获取指定父索引的行数。
virtual bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override 设置指定索引的数据。
virtual bool setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole) override 设置表头数据。
virtual bool setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles) override 设置指定索引的项数据。
virtual void sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override 根据指定列和顺序对模型进行排序。
virtual Qt::DropActions supportedDropActions() const override 获取支持的拖放操作。
函数签名 详细用途
void itemChanged(QStandardItem *item) 当项数据发生变化时发出信号。

QTableView

QTableView 实现了显示模型中项目的表格视图。此类用于提供以前由 QTable 类提供的标准表格,但使用 Qt 的模型/视图架构提供的更灵活的方法。

QTableView 实现了 QAbstractItemView 类定义的接口,使其能够显示由从 QAbstractItemModel 类派生的模型提供的数据。

导航

您可以通过用鼠标单击单元格或使用箭头键来导航表格中的单元格。由于 QTableView 默认启用 tabKeyNavigation,因此您也可以按 Tab 和 Backtab 从一个单元格移动到另一个单元格。

视觉外观

表格有一个垂直标题,可以使用 verticalHeader() 函数获得,还有一个水平标题,可以通过 HorizontalHeader() 函数获得。可以使用 rowHeight() 找到表格中每行的高度;类似地,可以使用 columnWidth() 找到列的宽度。由于这两个都是普通的小部件,因此您可以使用它们的 hide() 函数隐藏它们。每个标题都配置为将其 highlightSections 和 sectionClickable 属性设置为 true。

可以使用 hideRow()、hideColumn()、showRow() 和 showColumn() 隐藏和显示行和列。可以使用 selectRow() 和 selectColumn() 选择它们。表格将根据 showGrid 属性显示网格。

表格视图中显示的项目(与其他项目视图中的项目一样)使用标准委托进行渲染和编辑。但是,对于某些任务,有时能够在表格中插入小部件会很有用。使用 setIndexWidget() 函数为特定索引设置小部件,然后使用 indexWidget() 检索。

默认情况下,表格中的单元格不会扩展以填充可用空间。您可以通过拉伸最后一个标题部分使单元格填充可用空间。使用 HorizontalHeader() 或 VerticalHeader() 访问相关标题并设置标题的 stretchLastSection 属性。要根据每列或每行的空间要求分配可用空间,请调用视图的 resizeColumnsToContents() 或 resizeRowsToContents() 函数。

坐标系统

对于某些特殊形式的表,能够在行和列索引与小部件坐标之间进行转换非常有用。 rowAt() 函数提供指定行视图内的 y 坐标;可以使用行索引通过 rowViewportPosition() 获取相应的 y 坐标。 columnAt() 和 columnViewportPosition() 函数提供 x 坐标和列索引之间的等效转换操作。

API

函数签名 详细用途
QTableView(QWidget *parent = nullptr) 创建一个表格视图,父对象可选。
virtual ~QTableView() 析构函数,用于清理视图。
void clearSpans() 清除所有单元格的合并状态。
int columnAt(int x) const 根据给定的 x 坐标获取列索引。
int columnSpan(int row, int column) const 获取指定单元格的列合并跨度。
int columnViewportPosition(int column) const 获取指定列在视口中的位置。
int columnWidth(int column) const 获取指定列的宽度。
Qt::PenStyle gridStyle() const 获取网格线样式。
QHeaderView * horizontalHeader() const 获取水平表头的视图。
bool isColumnHidden(int column) const 检查指定列是否被隐藏。
bool isCornerButtonEnabled() const 检查角按钮是否启用。
bool isRowHidden(int row) const 检查指定行是否被隐藏。
bool isSortingEnabled() const 检查排序功能是否启用。
int rowAt(int y) const 根据给定的 y 坐标获取行索引。
int rowHeight(int row) const 获取指定行的高度。
int rowSpan(int row, int column) const 获取指定单元格的行合并跨度。
int rowViewportPosition(int row) const 获取指定行在视口中的位置。
void setColumnHidden(int column, bool hide) 设置指定列的可见性。
void setColumnWidth(int column, int width) 设置指定列的宽度。
void setCornerButtonEnabled(bool enable) 启用或禁用角按钮。
void setGridStyle(Qt::PenStyle style) 设置网格线的样式。
void setHorizontalHeader(QHeaderView *header) 设置水平表头视图。
void setRowHeight(int row, int height) 设置指定行的高度。
void setRowHidden(int row, bool hide) 设置指定行的可见性。
void setSortingEnabled(bool enable) 启用或禁用排序功能。
void setSpan(int row, int column, int rowSpanCount, int columnSpanCount) 设置单元格的合并跨度。
void setVerticalHeader(QHeaderView *header) 设置垂直表头视图。
void setWordWrap(bool on) 启用或禁用单元格内容的自动换行。
bool showGrid() const 检查网格线是否可见。
QHeaderView * verticalHeader() const 获取垂直表头的视图。
bool wordWrap() const 检查单元格内容的换行状态。
函数签名 详细用途
virtual QModelIndex indexAt(const QPoint &pos) const override 根据给定位置获取模型索引。
virtual void scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) override 滚动视图以显示指定索引。
virtual void setModel(QAbstractItemModel *model) override 设置视图的数据模型。
virtual void setRootIndex(const QModelIndex &index) override 设置根索引。
virtual void setSelectionModel(QItemSelectionModel *selectionModel) override 设置选择模型。
virtual QRect visualRect(const QModelIndex &index) const override 获取指定索引的可视矩形区域。
函数签名 详细用途
void hideColumn(int column) 隐藏指定列。
void hideRow(int row) 隐藏指定行。
void resizeColumnToContents(int column) 调整指定列的宽度以适应内容。
void resizeColumnsToContents() 调整所有列的宽度以适应内容。
void resizeRowToContents(int row) 调整指定行的高度以适应内容。
void resizeRowsToContents() 调整所有行的高度以适应内容。
void selectColumn(int column) 选择指定列。
void selectRow(int row) 选择指定行。
void setShowGrid(bool show) 设置网格线的可见性。
void showColumn(int column) 显示指定列。
void showRow(int row) 显示指定行。
void sortByColumn(int column, Qt::SortOrder order) 根据指定列和顺序进行排序。
函数签名 详细用途
virtual void currentChanged(const QModelIndex &current, const QModelIndex &previous) override 当前索引改变时的处理。
virtual void dropEvent(QDropEvent *event) override 处理拖放事件。
virtual int horizontalOffset() const override 获取水平偏移量。
virtual void initViewItemOption(QStyleOptionViewItem *option) const override 初始化视图项选项。
virtual bool isIndexHidden(const QModelIndex &index) const override 检查指定索引是否隐藏。
virtual QModelIndex moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override 移动光标。
virtual void paintEvent(QPaintEvent *event) override 处理绘制事件。
virtual void scrollContentsBy(int dx, int dy) override 根据指定的偏移量滚动内容。
virtual QModelIndexList selectedIndexes() const override 获取当前选择的索引列表。
virtual void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) override 选择改变时的处理。
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags) override 设置选择区域。
virtual int sizeHintForColumn(int column) const override 获取指定列的建议大小。
virtual int sizeHintForRow(int row) const override 获取指定行的建议大小。
virtual void timerEvent(QTimerEvent *event) override 处理定时器事件。
virtual void updateGeometries() override 更新几何形状。
virtual int verticalOffset() const override 获取垂直偏移量。
virtual QSize viewportSizeHint() const override 获取视口的建议大小。
virtual QRegion visualRegionForSelection(const QItemSelection &selection) const override 获取选择区域的可视区域。
函数签名 详细用途
void columnCountChanged(int oldCount, int newCount) 列数变化时的处理。
void columnMoved(int column, int oldIndex, int newIndex) 列移动时的处理。
void columnResized(int column, int oldWidth, int newWidth) 列大小变化时的处理。
void rowCountChanged(int oldCount, int newCount) 行数变化时的处理。
void rowMoved(int row, int oldIndex, int newIndex) 行移动时的处理。
void rowResized(int row, int oldHeight, int newHeight) 行大小变化时的处理。

样例:解析一个表格txt文件

复制代码
测深(m)   垂深(m)   方位(°)   总位移(m)  固井质量    测井取样    
252 252 241.27  0.51    优   1
275 275 241.27  0.72    优   1
300 300 235.82  0.9 良   1
325 325 239.23  1.09    良   1
350 350 243.02  1.27    一般  1
375 375 245.25  1.48    一般  1
400 399.99  243.12  1.72    优   1
425 424.99  238.72  1.93    优   1
450 449.99  242.6   2.22    良   1
475 474.99  239.52  2.51    良   1
500 499.99  228.03  2.83    一般  0
525 524.99  237.27  3.21    一般  0
550 549.98  249.85  3.76    优   0
575 574.95  254.77  4.88    优   0
600 599.87  258.18  6.84    良   1
625 624.83  274.63  8.13    良   1
650 649.79  302.42  9.08    一般  1
675 674.79  344.37  9.14    一般  1
700 699.78  89.22   8.55    优   0
725 724.77  116.77  8.07    优   0
750 749.77  92.9    7.46    良   0
775 774.76  95.93   6.98    良   0
800 799.76  206.45  7.07    一般  0
825 824.76  206.45  7.17    一般  0
850 849.76  211.82  7.25    优   0
​

我们现在来解析这个文件,怎么做呢?

设计一个简单的Ui文件。

初始化:

复制代码
MainWindow::MainWindow(QWidget* parent)
    : QMainWindow(parent), ui(new Ui::MainWindow) {
    ui->setupUi(this);
    model = new QStandardItemModel(2, FixedColumnCount, this);  // 创建数据模型
    selection = new QItemSelectionModel(model, this);  // 创建选择模型
​
    // 为tableView设置数据模型
    ui->tableView->setModel(model);               // 设置数据模型
    ui->tableView->setSelectionModel(selection);  // 设置选择模型
    ui->tableView->setSelectionMode(QAbstractItemView::ExtendedSelection);
    ui->tableView->setSelectionBehavior(QAbstractItemView::SelectItems);
}

读取:

复制代码
void MainWindow::openFileFromDialog() {
    QString fromFilePath = QFileDialog::getOpenFileName(
        this, "打开一个文件", ".", "井数据文件(*.txt);;所有文件(*.*)");
    loadFile(fromFilePath);
}
​
void MainWindow::loadFile(const QString& filePath) {
    if (filePath.isEmpty()) return;
​
    QFile f(filePath);
    if (!f.open(QIODevice::ReadOnly | QIODevice::Text)) return;
​
    QTextStream streamReader(&f);
    QStringList list;
    while (!streamReader.atEnd()) {
        const QString res = streamReader.readLine();
        list << res;
    }
​
    analysisPlainToTable(list);
}
​
void MainWindow::analysisPlainToTable(const QStringList& plainList) {
    int row_ready_display = plainList.size();
    if (row_ready_display < 1) return;  // invalid lists in size
    // for the frist we shell init headers
    model->setRowCount(row_ready_display - 1);
    static QRegularExpression reg("\\s+");
    // init headers
    const QString     header  = plainList[0];
    const QStringList headers = header.split(reg, Qt::SkipEmptyParts);
    model->setHorizontalHeaderLabels(headers);
​
    // init body
    for (int each_row = 1; each_row < row_ready_display; each_row++) {
        const QString     each_row_str = plainList[each_row];
        const QStringList word_list =
            each_row_str.split(reg, Qt::SkipEmptyParts);
        if (word_list.size() != FixedColumnCount) continue;  // avoid invalid!
        for (int each_column = 0; each_column < FixedColumnCount - 1;
             each_column++) {
            auto item = new QStandardItem(word_list[each_column]);
            model->setItem(each_row - 1, each_column, item);
        }
​
        // at finial
        auto final_checkable = new QStandardItem(headers[FixedColumnCount - 1]);
        final_checkable->setCheckable(true);
        if (word_list[FixedColumnCount - 1] == "0") {
            final_checkable->setCheckState(Qt::Unchecked);
        } else {
            final_checkable->setCheckState(Qt::Checked);
        }
        model->setItem(each_row - 1, FixedColumnCount - 1, final_checkable);
    }
}

可以看到,我们的写入数据就会放到类里面了。

相关推荐
MessiGo40 分钟前
C/C++ 知识点:重载、覆盖和隐藏
c++
runing_an_min1 小时前
windows运行ffmpeg的脚本报错:av_ts2str、av_ts2timestr、av_err2str => E0029 C4576
c++·windows·ffmpeg·e0029
无敌岩雀1 小时前
C++设计模式结构型模式———桥接模式
c++·设计模式·桥接模式
麻由由哒哟2 小时前
CSP-J2023T4 旅游巴士(同余最短路)
c++·算法
码农客栈4 小时前
qt QWizard详解
qt
攻城狮7号4 小时前
【5.5】指针算法-三指针解决颜色分类
c++·算法
OKkankan4 小时前
单链表的实现(数据结构)
java·c语言·数据结构·c++
gkdpjj4 小时前
二叉树中的深搜
c++·算法
醉颜凉4 小时前
【NOIP普及组】明明的随机数
java·c语言·数据结构·c++·算法
fhvyxyci4 小时前
【C++之STL】一文学会使用 string
开发语言·数据结构·c++·stl