Класс QSqlQueryModel

Класс QSqlQueryModel предоставляет модель данных только для чтения для наборов результатов SQL. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Открытые функции

Переопределённые открытые функции

• 4 открытые функции унаследованы от QAbstractTableModel
• 40 открытые функции унаследованы от QAbstractItemModel
• 31 открытые функции унаследованы от QObject

Статические открытые члены

• 9 статических открытых членов унаследованы от QObject

Защищённые функции

• 19 защищённые функции унаследованы от QAbstractItemModel
• 9 защищённые функции унаследованы от QObject

Дополнительные наследуемые члены

• 1 свойство унаследовано от QObject
• 2 открытые слоты унаследованы от QAbstractItemModel
• 1 открытый слот унаследован от QObject
• 18 сигналов унаследованы от QAbstractItemModel
• 2 сигнала унаследованы от QObject
• 1 защищённый слот унаследован от QAbstractItemModel

Подробное описание

Класс QSqlQueryModel предоставляет модель данных только для чтения для наборов результатов SQL.

QSqlQueryModel — это интерфейс высокого уровня для выполнения SQL-запросов и обхода набора результатов. Он построен на базе QSqlQuery и может использоваться для предоставления данных классам представлений, таким как QTableView. Например:

    QSqlQueryModel *model = new QSqlQueryModel;
    model->setQuery("SELECT name, salary FROM employee");
    model->setHeaderData(0, Qt::Horizontal, tr("Name"));
    model->setHeaderData(1, Qt::Horizontal, tr("Salary"));

    QTableView *view = new QTableView;
    view->setModel(model);
    view->show();

Мы устанавливаем запрос модели, а затем настраиваем метки, отображаемые в заголовке представления.

QSqlQueryModel также может использоваться для доступа к базе данных программно, не привязывая её к представлению:

    QSqlTableModel model;
    model.setTable("employee");
    model.select();
    int salary = model.record(4).value("salary").toInt();

В приведенном выше фрагменте кода извлекается поле salary из записи 4 в наборе результатов запроса SELECT * from employee. Предполагая, что salary является столбцом 2, мы можем переписать последнюю строку следующим образом:

    int salary = model.data(model.index(4, 2)).toInt();

Модель по умолчанию является моделью только для чтения. Чтобы сделать её чтением и записью, необходимо создать подкласс и переопределить setData() и flags(). Другой вариант — использовать QSqlTableModel, который предоставляет чтению и запись модели на основе одного таблицы базы данных.

Пример querymodel демонстрирует, как использовать QSqlQueryModel для отображения результата запроса. Он также показывает, как создать подкласс QSqlQueryModel для настройки содержимого данных перед отображением его пользователю, и как создать модель чтения и записи на основе QSqlQueryModel.

Если база данных не возвращает количество выбранных строк в запросе, модель будет извлекать строки по частям. Дополнительная информация об этом содержится в fetchMore().

См. также QSqlTableModel, QSqlRelationalTableModel, QSqlQuery, Программирование моделей/представлений и Пример запроса модели.

Документация по функциям-членам

QSqlQueryModel::QSqlQueryModel(QObject *parent = nullptr)

Создаёт пустую модель QSqlQueryModel с заданным parent.

[virtual] QSqlQueryModel::~QSqlQueryModel()

Удаляет объект и освобождает все выделенные ресурсы.

См. также clear().

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

Переопределено из QAbstractItemModel::canFetchMore().

Возвращает true true, если можно прочитать больше строк из базы данных. Это относится только к базам данных, которые не сообщают размер запроса (см. QSqlDriver::hasFeature()).

parent всегда должен быть недопустимым QModelIndex.

Эта функция была добавлена в Qt 4.1.

См. также fetchMore().

[virtual] void QSqlQueryModel::clear()

Очищает модель и освобождает все полученные ресурсы.

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

Переопределено из QAbstractItemModel::columnCount().

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

Переопределено из QAbstractItemModel::data().

Возвращает значение для указанного элемента item и роли role.

Если item находится за пределами допустимого диапазона или произошла ошибка, возвращается недопустимый QVariant.

См. также lastError().

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

Переопределено из QAbstractItemModel::fetchMore().

Загружает дополнительные строки из базы данных. Это влияет только на базы данных, которые не сообщают размер запроса (см. QSqlDriver::hasFeature() ).

Для принудительной загрузки всего набора результатов вы можете использовать следующее:

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

parent всегда должен быть недопустимым QModelIndex.

Эта функция была добавлена в Qt 4.1.

См. также canFetchMore().

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

Переопределено из QAbstractItemModel::headerData().

Возвращает данные заголовка для заданной роли 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().

Вставляет count столбцов в модель в позиции column. Параметр parent всегда должен быть недопустимым QModelIndex, так как модель не поддерживает родительские-потомковые отношения.

Возвращает true если column находится в допустимом диапазоне; в противном случае возвращает 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().

QSqlQuery QSqlQueryModel::query() const

Возвращает связанный с этой моделью QSqlQuery.

См. также setQuery().

[virtual protected] void QSqlQueryModel::queryChange()

Этот виртуальный метод вызывается всякий раз, когда запрос меняется. По умолчанию он ничего не делает.

query() возвращает новый запрос.

См. также query() и setQuery().

QSqlRecord QSqlQueryModel::record(int row) const

Возвращает запись, содержащую информацию о полях текущего запроса. Если row — индекс корректной строки, запись будет заполнена значениями из этой строки.

Если модель не инициализирована, будет возвращена пустая запись.

См. также QSqlRecord::isEmpty().

QSqlRecord QSqlQueryModel::record() const

Это перегруженный метод.

Возвращает пустую запись, содержащую информацию о полях текущего запроса.

Если модель не инициализирована, будет возвращена пустая запись.

См. также QSqlRecord::isEmpty().

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

Переопределено из QAbstractItemModel::removeColumns().

Удаляет count столбцов из модели, начиная с позиции column. Параметр parent всегда должен быть недопустимым QModelIndex, так как модель не поддерживает родительские-потомковые отношения.

Удаление столбцов фактически скрывает их. Оно не влияет на базовый QSqlQuery.

Возвращает true если столбцы были удалены; в противном случае возвращает false.

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

Переопределено из QAbstractItemModel::roleNames().

Возвращает имена ролей модели.

Qt определяет только одну роль для QSqlQueryModel:

Эта функция была добавлена в Qt 5.10.

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

Переопределено из QAbstractItemModel::rowCount().

Если база данных поддерживает возврат размера запроса (см. QSqlDriver::hasFeature() ), возвращает количество строк текущего запроса. В противном случае возвращает количество строк, в настоящее время кэшированных на клиенте.

parent всегда должен быть недопустимым QModelIndex.

Эта функция была добавлена в Qt 4.1.

См. также canFetchMore() и QSqlDriver::hasFeature().

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

Переопределено из QAbstractItemModel::setHeaderData().

Устанавливает заголовок горизонтального заголовка для указанной роли role со значением value. Это полезно, если модель используется для отображения данных в представлении (например, QTableView).

Возвращает true если orientation равен Qt::Horizontal и section относится к допустимому разделу; в противном случае возвращает false.

Обратите внимание, что этот метод не может использоваться для изменения значений в базе данных, так как модель является только для чтения.

См. также headerData() и data().

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

Защищённая функция, которая позволяет производным классам установить значение последней ошибки, произошедшей в базе данных, в error.

См. также lastError().

void QSqlQueryModel::setQuery(const QSqlQuery &query)

Сбрасывает модель и устанавливает поставщика данных на заданный запрос query. Обратите внимание, что запрос должен быть активен и не должен быть isForwardOnly().

lastError() может быть использован для получения подробной информации, если при установке запроса произошла ошибка.

Примечание: Вызов setQuery() удалит все вставленные столбцы.

См. также query(), QSqlQuery::isActive(), QSqlQuery::setForwardOnly() и lastError().

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

Это перегруженный метод.

Выполняет запрос query для заданного подключения к базе данных db. Если база данных не указана (или база данных недействительна), используется подключение по умолчанию.

lastError() можно использовать для получения подробной информации, если произошла ошибка при настройке запроса.

Пример:

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

См. также query(), queryChange(), и lastError().