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

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

样例：解析一个表格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);
    }
}

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