Класс QSqlRelationalTableModel

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

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

Типы

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

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

• 27 открытых функций унаследованных от QSqlTableModel
• 16 открытых функций унаследованных от QSqlQueryModel
• 4 открытых функции унаследованных от QAbstractTableModel
• 39 открытых функций унаследованных от QAbstractItemModel
• 31 открытых функций унаследованных от QObject

Открытые слоты

• 6 открытых слотов унаследованных от QSqlTableModel
• 2 открытых слотов унаследованных от QAbstractItemModel
• 1 открытый слот унаследованный от QObject

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

• 9 защищенных функций унаследованных от QSqlTableModel
• 3 защищенных функций унаследованных от QSqlQueryModel
• 19 защищенных функций унаследованных от QAbstractItemModel
• 9 защищенных функций унаследованных от QObject

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

• 1 свойство унаследованное от QObject
• 4 сигналов унаследованных от QSqlTableModel
• 18 сигналов унаследованных от QAbstractItemModel
• 2 сигналов унаследованных от QObject
• 11 статических открытых членов унаследованных от QObject
• 9 защищенных функций унаследованных от QSqlTableModel
• 3 защищенных функций унаследованных от QSqlQueryModel
• 19 защищенных функций унаследованных от QAbstractItemModel
• 9 защищенных функций унаследованных от QObject
• 1 защищенный слот унаследованный от QAbstractItemModel

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

Класс 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's 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 = Q_NULLPTR, QSqlDatabase db = QSqlDatabase())

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

[virtual] QSqlRelationalTableModel::~QSqlRelationalTableModel()

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

[virtual] void QSqlRelationalTableModel::clear()

Переопределено из QSqlQueryModel::clear().

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

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

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

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

Переопределено из QSqlTableModel::insertRowIntoTable().

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

Переопределено из QSqlTableModel::orderByClause().

QSqlRelation QSqlRelationalTableModel::relation(int column) const

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

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

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

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

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

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

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

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

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

Переопределено из QSqlTableModel::revertRow().

[virtual] bool QSqlRelationalTableModel::select()

Переопределено из QSqlTableModel::select().

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

Переопределено из QSqlTableModel::selectStatement().

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

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

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

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

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

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

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

Устанавливает режим SQL-соединения для отображения или скрытия строк с 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 таблицы name.

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

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

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

Переопределено из QSqlTableModel::setTable().

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

Переопределено из QSqlTableModel::updateRowInTable().