Представление данных в табличном виде

Классы QSqlQueryModel, QSqlTableModel и QSqlRelationalTableModel могут быть использованы в качестве источника данных для классов представления Qt, таких как QListView, QTableView и QTreeView. На практике, QTableView является наиболее распространённым выбором, так как результат запроса SQL представляет собой по существу двумерную структуру данных.

В следующем примере создаётся представление на основе модели данных SQL:

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

Если модель является моделью чтения-записи (например, QSqlTableModel), представление позволяет пользователю редактировать поля. Вы можете отключить это, вызвав

    view->setEditTriggers(QAbstractItemView::NoEditTriggers);

Вы можете использовать одну и ту же модель в качестве источника данных для нескольких представлений. Если пользователь редактирует модель через одно из представлений, другие представления сразу же отобразят изменения. Пример Модель таблицы демонстрирует, как это работает.

Классы представлений отображают заголовок в верхней части для маркировки столбцов. Чтобы изменить тексты заголовков, вызовите setHeaderData() в модели. По умолчанию метки заголовка соответствуют именам полей таблицы. Например:

    model->setHeaderData(0, Qt::Horizontal, QObject::tr("ID"));
    model->setHeaderData(1, Qt::Horizontal, QObject::tr("Name"));
    model->setHeaderData(2, Qt::Horizontal, QObject::tr("City"));
    model->setHeaderData(3, Qt::Horizontal, QObject::tr("Country"));

QTableView также имеет вертикальный заголовок слева с номерами, идентифицирующими строки. Если вы программно вставляете строки, используя QSqlTableModel::insertRows(), новые строки будут помечены звёздочкой (*) до тех пор, пока они не будут отправлены с помощью submitAll() или автоматически, когда пользователь переходит к другой записи (предполагая, что стратегия редактирования edit strategy является QSqlTableModel::OnRowChange).

Аналогично, если вы удаляете строки, используя removeRows(), строки будут помечены восклицательным знаком (!) до тех пор, пока изменение не будет отправлено.

Элементы в представлении рендерятся с помощью делегата. Делегат по умолчанию, QItemDelegate, обрабатывает наиболее распространённые типы данных (int, QString, QImage и т.д.). Делегат также отвечает за предоставление виджетов редактора (например, выпадающего списка), когда пользователь начинает редактирование элемента в представлении. Вы можете создать собственные делегаты, наследуя от QAbstractItemDelegate или QItemDelegate. Подробнее см. Моделирование/Программирование с помощью представлений.

QSqlTableModel оптимизирован для работы с одной таблицей за раз. Если вам нужна модель чтения-записи, работающая с произвольным набором результатов, вы можете унаследовать от QSqlQueryModel и переопределить flags() и setData(), чтобы сделать её моделью чтения-записи. Следующие две функции делают поля 1 и 2 модели запроса редактируемыми:

Qt::ItemFlags EditableSqlModel::flags(
        const QModelIndex &index) const
{
    Qt::ItemFlags flags = QSqlQueryModel::flags(index);
    if (index.column() == 1 || index.column() == 2)
        flags |= Qt::ItemIsEditable;
    return flags;
}

bool EditableSqlModel::setData(const QModelIndex &index, const QVariant &value, int /* role */)
{
    if (index.column() < 1 || index.column() > 2)
        return false;

    QModelIndex primaryKeyIndex = QSqlQueryModel::index(index.row(), 0);
    int id = data(primaryKeyIndex).toInt();

    clear();

    bool ok;
    if (index.column() == 1) {
        ok = setFirstName(id, value.toString());
    } else {
        ok = setLastName(id, value.toString());
    }
    refresh();
    return ok;
}

Вспомогательная функция setFirstName() определена следующим образом:

bool EditableSqlModel::setFirstName(int personId, const QString &firstName)
{
    QSqlQuery query;
    query.prepare("update person set firstname = ? where id = ?");
    query.addBindValue(firstName);
    query.addBindValue(personId);
    return query.exec();
}

Функция setLastName() аналогична. См. пример Модель запроса для полного исходного кода.

Наследование от модели позволяет настроить её многими способами: вы можете предоставить всплывающие подсказки для элементов, изменить цвет фона, предоставить вычисленные значения, предоставить разные значения для просмотра и редактирования, обрабатывать значения NULL особым образом и многое другое. Подробнее см. Программирование с помощью моделей и представлений, а также справочную документацию QAbstractItemView.

Если всё, что вам нужно, это разрешить внешний ключ на более понятную строку, вы можете использовать QSqlRelationalTableModel. Для достижения наилучших результатов также следует использовать QSqlRelationalDelegate, делегат, предоставляющий редакторы выпадающих списков для редактирования внешних ключей.

Пример Модель связанной таблицы демонстрирует, как использовать QSqlRelationalTableModel в сочетании с QSqlRelationalDelegate для предоставления таблиц с поддержкой внешних ключей.