QSqlRelationalTableModel Class Reference

Member Function Documentation

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

Creates an empty QSqlRelationalTableModel and sets the parent to parent and the database connection to db. If db is not valid, the default database connection will be used.

QSqlRelationalTableModel::~QSqlRelationalTableModel () [virtual]

Destroys the object and frees any allocated resources.

void QSqlRelationalTableModel::clear () [virtual]

Reimplemented from QSqlQueryModel::clear().

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

Reimplemented from QAbstractItemModel::data().

See also setData().

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

Reimplemented from QSqlTableModel::insertRowIntoTable().

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

Reimplemented from QSqlTableModel::orderByClause().

QSqlRelation QSqlRelationalTableModel::relation ( int column ) const

Returns the relation for the column column, or an invalid relation if no relation is set.

See also setRelation() and QSqlRelation::isValid().

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

Returns a QSqlTableModel object for accessing the table for which column is a foreign key, or 0 if there is no relation for the given column.

The returned object is owned by the QSqlRelationalTableModel.

See also setRelation() and relation().

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

Reimplemented from QAbstractItemModel::removeColumns().

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

Reimplemented from QSqlTableModel::revertRow().

bool QSqlRelationalTableModel::select () [virtual]

Reimplemented from QSqlTableModel::select().

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

Reimplemented from QSqlTableModel::selectStatement().

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

Reimplemented from QAbstractItemModel::setData().

Sets the data for the role in the item with the specified index to the value given. Depending on the edit strategy, the value might be applied to the database at once, or it may be cached in the model.

Returns true if the value could be set, or false on error (for example, if index is out of bounds).

For relational columns, value must be the index, not the display value. The index must also exist in the referenced table, otherwise the function returns false.

See also editStrategy(), data(), submit(), and revertRow().

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

Sets the SQL join mode to the value given by joinMode to show or hide rows with NULL foreign keys.

In InnerJoin mode (the default) these rows will not be shown; use the LeftJoin mode if you want to show them.

This function was introduced in Qt 4.8.

See also QSqlRelationalTableModel::JoinMode.

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

Lets the specified column be a foreign index specified by relation.

Example:

     model->setTable("employee");

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

The setRelation() call specifies that column 2 in table employee is a foreign key that maps with field id of table city, and that the view should present the city's name field to the user.

Note: The table's primary key may not contain a relation to another table.

See also relation().

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

Reimplemented from QSqlTableModel::setTable().

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

Reimplemented from QSqlTableModel::updateRowInTable().