QSqlQueryModel Class

成员函数文档

[explicit] QSqlQueryModel::QSqlQueryModel(QObject *parent = nullptr)

使用给定的parent 创建一个空的QSqlQueryModel。

[virtual noexcept] QSqlQueryModel::~QSqlQueryModel()

销毁该对象并释放所有已分配的资源。

另请参阅 clear()。

[override virtual] bool QSqlQueryModel::canFetchMore(const QModelIndex &parent = QModelIndex()) const

重写：QAbstractItemModel::canFetchMore(const QModelIndex &parent) const。

如果可以从数据库中读取更多行，则返回 `true `。这仅影响那些不返回查询行数的数据库（参见 `QSqlDriver::hasFeature()`）。

parent 应始终返回一个无效的QModelIndex 。

另请参阅 fetchMore()。

[virtual] void QSqlQueryModel::clear()

清除模型并释放已获取的资源。

[override virtual] int QSqlQueryModel::columnCount(const QModelIndex &index = QModelIndex()) const

重写了：QAbstractItemModel::columnCount(const QModelIndex &parent) const。

[override virtual] QVariant QSqlQueryModel::data(const QModelIndex &item, int role = Qt::DisplayRole) const

重写：QAbstractItemModel::data(const QModelIndex &index, int role) const。

返回指定item 和role 的值。

如果item 超出范围或发生错误，则返回一个无效的QVariant 。

另请参阅 lastError()。

[override virtual] void QSqlQueryModel::fetchMore(const QModelIndex &parent = QModelIndex())

重写自：QAbstractItemModel::fetchMore(const QModelIndex &parent)。

从数据库中获取更多行。这仅影响那些不会返回查询结果大小的数据库（参见QSqlDriver::hasFeature()）。

若要强制获取整个结果集，可使用以下方法：

while (myModel->canFetchMore())
    myModel->fetchMore();

parent 应始终为一个无效的QModelIndex 。

另请参阅 canFetchMore()。

[override virtual] QVariant QSqlQueryModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

重写：QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const。

返回给定role 的头文件数据，该数据位于头文件的section 中，且具有指定的orientation 。

另请参阅 setHeaderData()。

[virtual protected] QModelIndex QSqlQueryModel::indexInQuery(const QModelIndex &item) const

返回模型中给定item 在数据库结果集中的索引。

如果未插入、删除或移动任何列或行，则返回值与 `item ` 完全相同。

如果 `item ` 超出范围，或者 `item ` 未指向结果集中的某个值，则返回一个无效的模型索引。

另请参阅 QSqlTableModel::indexInQuery()、insertColumns() 和removeColumns()。

[override virtual] bool QSqlQueryModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重写了：QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent)。

将count 列插入到模型中，位置为column 。parent 参数必须始终为无效的QModelIndex ，因为该模型不支持父子关系。

如果column 在有效范围内，则返回true ；否则返回false 。

默认情况下，插入的列为空。若要填充数据，请重写data() 并分别处理每个插入的列：

QVariant MyModel::data(const QModelIndex &item, int role) const
{
    if (item.column() == m_specialColumnNo) {
        // handle column separately
    }
    return QSqlQueryModel::data(item, role);
}

另请参阅 removeColumns()。

QSqlError QSqlQueryModel::lastError() const

返回有关数据库中最近一次错误的信息。

另请参阅 setLastError() 和query()。

const QSqlQuery &QSqlQueryModel::query() const

返回与该模型关联的 constQSqlQuery 对象的引用。

另请参阅 setQuery()。

[virtual protected] void QSqlQueryModel::queryChange()

每当查询发生变化时，都会调用此虚拟函数。默认实现不执行任何操作。

query() 返回新的查询。

另请参阅 query() 和setQuery()。

QSqlRecord QSqlQueryModel::record(int row) const

返回包含当前查询字段信息的记录。如果row 是有效行对应的索引，则该记录将填充该行的值。

如果模型未初始化，则返回一个空记录。

另请参阅 QSqlRecord::isEmpty()。

QSqlRecord QSqlQueryModel::record() const

返回一个包含当前查询字段信息的空记录。

如果模型未初始化，则将返回一个空记录。

另请参阅 QSqlRecord::isEmpty()。

[since 6.9] void QSqlQueryModel::refresh()

重新执行当前查询，从同一数据库连接中获取数据。

该函数在 Qt 6.9 中引入。

另请参阅 setQuery(QSqlQuery &&query) 和QSqlQuery::boundValue()。

[override virtual] bool QSqlQueryModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重写了：QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent)。

从位置column 开始，从模型中移除count 列。parent 参数必须始终为无效的QModelIndex ，因为该模型不支持父子关系。

删除列实际上是将其隐藏。这不会影响底层的QSqlQuery 。

如果列已被删除，则返回true ；否则返回false 。

[override virtual] QHash<int, QByteArray> QSqlQueryModel::roleNames() const

重写：QAbstractItemModel::roleNames() const。

返回模型的角色名称。

Qt 为QSqlQueryModel 仅定义了一个角色：

[override virtual] int QSqlQueryModel::rowCount(const QModelIndex &parent = QModelIndex()) const

重写了：QAbstractItemModel::rowCount(const QModelIndex &parent) const。

如果数据库支持返回查询的大小（参见QSqlDriver::hasFeature()），则返回当前查询的行数。否则，返回客户端当前缓存的行数。

parent 应始终为一个无效的QModelIndex 。

另请参阅 canFetchMore() 和QSqlDriver::hasFeature() 函数。

[override virtual] bool QSqlQueryModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

重写了：QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role)。

将指定role 的水平标题设置为value 。当模型用于在视图中显示数据时（例如QTableView ），此方法非常有用。

如果orientation 为Qt::Horizontal 且section 指向一个有效的部分，则返回true ；否则返回false。

请注意，由于该模型为只读模式，此函数无法用于修改数据库中的值。

另请参阅 headerData() 和data()。

[protected] void QSqlQueryModel::setLastError(const QSqlError &error)

一个受保护的方法，允许派生类将数据库中发生的最后一个错误的值设置为error 。

另请参阅 lastError()。

[since 6.2] void QSqlQueryModel::setQuery(QSqlQuery &&query)

重置模型，并将数据提供者设置为给定的query 。请注意，该查询必须处于活动状态，且不能为isForwardOnly()。

lastError如果设置查询时发生错误，可使用 () 方法获取详细信息。

此函数在 Qt 6.2 中引入。

另请参阅 query()、QSqlQuery::isActive()、QSqlQuery::setForwardOnly() 和lastError()。

void QSqlQueryModel::setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase())

针对给定的数据库连接 `db` 执行查询 `query `。如果未指定数据库（或指定了无效的数据库），则使用默认连接。

lastError如果设置查询时发生错误，可以使用 () 获取详细信息。

示例：

QSqlQueryModel model;
model.setQuery("select * from MyTable");
if(model.lastError().isValid())
    qDebug() << model.lastError();

另请参阅 query()、queryChange 和lastError 。