Класс QSqlRelationalTableModel

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

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

Открытые типы

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

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

• 27 открытых функций, унаследованных от QSqlTableModel
• 16 открытых функций, унаследованных от QSqlQueryModel
• 4 открытых функции, унаследованных от QAbstractTableModel
• 39 открытых функций, унаследованных от QAbstractItemModel
• 32 открытых функций, унаследованных от 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

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

Класс 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 = 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 режим объединения joinMode для отображения или скрытия строк с NULL внешними ключами. В режиме внутреннего объединения (по умолчанию) эти строки не будут отображаться: используйте режим левого объединения, если хотите отобразить их.

Эта функция была введена в 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().