Класс QSqlRelationalTableModel

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

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

Типы Public

Функции Public

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

• 27 функций public, унаследованных от QSqlTableModel
• 17 функций public, унаследованных от QSqlQueryModel
• 7 функций public, унаследованных от QAbstractTableModel
• 43 функции public, унаследованные от QAbstractItemModel
• 34 функции public, унаследованные от QObject

Свойства Public

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

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

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

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

• 1 свойство, унаследованное от QObject
• 4 сигнала, унаследованные от QSqlTableModel
• 18 сигналов, унаследованных от QAbstractItemModel
• 2 сигнала, унаследованные от QObject
• 1 переменная public, унаследованная от QAbstractTableModel
• 1 переменная public, унаследованная от QAbstractItemModel
• 1 переменная public, унаследованная от QObject
• 2 статических public членов, унаследованных от QAbstractTableModel
• 2 статических public членов, унаследованных от QAbstractItemModel
• 10 статических public членов, унаследованных от QObject
• 9 функций protected, унаследованных от QSqlTableModel
• 3 функции protected, унаследованные от QSqlQueryModel
• 19 функций protected, унаследованных от QAbstractItemModel
• 9 функций protected, унаследованных от QObject
• 1 protected slot, унаследованный от QAbstractItemModel
• 2 защищённых переменных, унаследованных от 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'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 и Пример реляционной модели таблицы.

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

enum QSqlRelationalTableModel::JoinMode

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

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

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

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

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

[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().

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

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

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

[override 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().

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

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

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

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

[override virtual] bool QSqlRelationalTableModel::select()

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

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

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

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

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

Устанавливает данные для роли 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 таблицы name пользователю.

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

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

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

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

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

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