Класс QSqlRelationalTableModel

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

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

Типы публичного доступа

Функции публичного доступа

Переопределённые функции публичного доступа

Свойства публичного доступа

Переопределённые защищённые функции

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

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

На левом снимке показана обычная модель QSqlTableModel в QTableView. Внешние ключи (city и country) не разрешаются в удобочитаемые значения. На правом снимке показана модель QSqlRelationalTableModel, где внешние ключи разрешаются в удобочитаемые текстовые строки.

Следующий фрагмент кода показывает, как была настроена модель QSqlRelationalTableModel:

    model->setTable("employee");

    model->setRelation(2, QSqlRelation("city", "id", "name"));
    model->setRelation(3, QSqlRelation("country", "id", "name"));

Функции setRelation() устанавливают взаимосвязь между двумя таблицами. Первый вызов указывает, что столбец 2 в таблице employee является внешним ключом, который сопоставляется с полем id таблицы city, и что представление должно отображать поле city таблицы name пользователю. Второй вызов делает то же самое со столбцом 3.

Если вы используете модель QSqlRelationalTableModel для чтения и записи, то, вероятно, вам понадобится использовать QSqlRelationalDelegate в представлении. В отличие от стандартного делегата, QSqlRelationalDelegate предоставляет раскрывающееся меню для полей, которые являются внешними ключами в другие таблицы. Для использования класса просто вызовите QAbstractItemView::setItemDelegate() в представлении с экземпляром QSqlRelationalDelegate:

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

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

Примечания:

• Таблица должна иметь объявленный первичный ключ.
• Первичный ключ таблицы не может содержать связь с другой таблицей.
• Если реляционная таблица содержит ключи, которые ссылаются на несуществующие строки в связанной таблице, строки, содержащие недействительные ключи, не будут отображаться через модель. Пользователь или база данных отвечает за поддержание целостности ссылок.
• Если имя отображаемого столбца отношения также используется в качестве имени столбца в реляционной таблице, или если оно используется как имя отображаемого столбца в более чем одном отношении, оно будет алиасировано. Псевдоним — это имя таблицы отношения, имя отображаемого столбца и уникальный идентификатор, соединенные символом подчеркивания (например, tablename_columnname_id). QSqlRecord::fieldName() вернет алиасированное имя столбца. Все случаи дублирования имени отображаемого столбца алиасируются при обнаружении дублирования, но никакое алиасирование не выполняется для имен столбцов в основной таблице. Алиасирование не влияет на QSqlRelation, поэтому QSqlRelation::displayColumn() вернет исходное имя отображаемого столбца.
• Имя таблицы-ссылки алиасируется. Псевдоним — слово "relTblAl", а индекс связанного столбца соединен символом подчеркивания (например, relTblAl_2). Псевдоним может использоваться для фильтрации таблицы (например, setFilter("relTblAl_2='Oslo' OR relTblAl_3='USA'")).
• При использовании setData() роль всегда должна быть Qt::EditRole, а при использовании data() роль всегда должна быть Qt::DisplayRole.

См. также QSqlRelation, QSqlRelationalDelegate и Пример реляционной модели таблицы.

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

Перечисление QSqlRelationalTableModel::JoinMode

Это перечисление было введено или изменено в Qt 4.8.

См. также QSqlRelationalTableModel::setJoinMode().

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

QSqlRelationalTableModel::QSqlRelationalTableModel(QObject *parent = nullptr, QSqlDatabase db = QSqlDatabase())

Создает пустую модель QSqlRelationalTableModel и устанавливает родителя в parent, а подключение к базе данных в db. Если db недействительно, используется подключение по умолчанию.

[override virtual slot] void QSqlRelationalTableModel::revertRow(int row)

Переопределяет: QSqlTableModel::revertRow(int row).

[virtual] QSqlRelationalTableModel::~QSqlRelationalTableModel()

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

[override virtual] void QSqlRelationalTableModel::clear()

Переопределяет: QSqlTableModel::clear().

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

Переопределяет: QSqlTableModel::data(const QModelIndex &index, int role) const.

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

[override virtual protected] bool QSqlRelationalTableModel::insertRowIntoTable(const QSqlRecord &values)

Переопределяет: QSqlTableModel::insertRowIntoTable(const QSqlRecord &values).

[override virtual protected] QString QSqlRelationalTableModel::orderByClause() const

Переопределяет: QSqlTableModel::orderByClause() const.

QSqlRelation QSqlRelationalTableModel::relation(int column) const

Возвращает отношение для столбца column или недействительное отношение, если отношение не установлено.

См. также setRelation() и QSqlRelation::isValid().

[virtual] QSqlTableModel *QSqlRelationalTableModel::relationModel(int column) const

Возвращает объект QSqlTableModel для доступа к таблице, для которой column является внешним ключом, или nullptr если для данного column нет отношения.

Возвращаемый объект принадлежит QSqlRelationalTableModel.

См. также setRelation() и relation().

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

Переопределяет: QSqlTableModel::removeColumns(int column, int count, const QModelIndex &parent).

[override virtual] bool QSqlRelationalTableModel::select()

Переопределяет: QSqlTableModel::select().

[override virtual protected] QString QSqlRelationalTableModel::selectStatement() const

Переопределяет: QSqlTableModel::selectStatement() const.

[override virtual] bool QSqlRelationalTableModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

Переопределяет: QSqlTableModel::setData(const QModelIndex &index, const QVariant &value, int role).

Устанавливает данные для роли role в элементе с указанным index на value. В зависимости от стратегии редактирования, значение может быть применено к базе данных сразу или может быть кэшировано в модели.

Возвращает true если значение можно установить или false при ошибке (например, если index выходит за пределы границ).

Для реляционных столбцов value должно быть индексом, а не отображаемым значением. Индекс также должен существовать в связанной таблице, в противном случае функция возвращает false.

См. также editStrategy(), data(), submit() и revertRow().

void QSqlRelationalTableModel::setJoinMode(QSqlRelationalTableModel::JoinMode joinMode)

Устанавливает режим SQL joinMode для отображения или скрытия строк с NULL внешними ключами. В режиме InnerJoin (по умолчанию) эти строки не отображаются: используйте режим LeftJoin, если хотите их отобразить.

Данная функция была добавлена в Qt 4.8.

См. также QSqlRelationalTableModel::JoinMode.

[virtual] void QSqlRelationalTableModel::setRelation(int column, const QSqlRelation &relation)

Разрешает указанному column быть внешним индексом, заданным relation.

Пример:

    model->setTable("employee");

    model->setRelation(2, QSqlRelation("city", "id", "name"));

Вызов setRelation() указывает, что столбец 2 в таблице employee является внешним ключом, который сопоставляется с полем id таблицы city, и что представление должно отображать поле city's name пользователю.

Примечание: первичный ключ таблицы может не содержать отношения к другой таблице.

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

[override virtual] void QSqlRelationalTableModel::setTable(const QString &table)

Переопределяет: QSqlTableModel::setTable(const QString &tableName).

[override virtual protected] bool QSqlRelationalTableModel::updateRowInTable(int row, const QSqlRecord &values)

Переопределяет: QSqlTableModel::updateRowInTable(int row, const QSqlRecord &values).