テーブル・ビューでのデータ表示

QSqlQueryModel 、QSqlTableModel 、QSqlRelationalTableModel の各クラスは、QListView 、QTableView 、QTreeView のような Qt のビュー・クラスのデータ・ソースとして使用することができます。実際には、QTableView が最も一般的な選択です。

以下の例では、SQLデータモデルに基づいてビューを作成します：

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

モデルが読み書き可能なモデルの場合（例えば、QSqlTableModel ）、ビューはユーザがフィールドを編集できるようにします。を呼び出すことで、これを無効にすることができます。

    view->setEditTriggers(QAbstractItemView::NoEditTriggers);

同じモデルを複数のビューのデータ・ソースとして使用できます。ユーザがビューの一つを通してモデルを編集した場合、他のビューはその変更を即座に反映します。テーブルモデルの例では、その仕組みを示しています。

ビュークラスは、カラムにラベルを付けるために上部にヘッダーを表示します。ヘッダーのテキストを変更するには、モデル上でsetHeaderData() を呼び出します。ヘッダーのラベルのデフォルトはテーブルのフィールド名です。たとえば

    model->setHeaderData(0, Qt::Horizontal, QObject::tr("ID"));
    model->setHeaderData(1, Qt::Horizontal, QObject::tr("Name"));
    model->setHeaderData(2, Qt::Horizontal, QObject::tr("City"));
    model->setHeaderData(3, Qt::Horizontal, QObject::tr("Country"));

QTableView また、左側には、行を識別する数字が書かれた垂直のヘッダーがあります。 () を使用してプログラムで行を挿入した場合、 () を使用して送信されるまで、またはユーザが別のレコードに移動したときに自動的に（ が であると仮定して）、新しい行にはアスタリスク (*) が付けられます。QSqlTableModel::insertRows submitAll edit strategy QSqlTableModel::OnRowChange

同様に、removeRows() を使用して行を削除すると、変更が送信されるまで、行には感嘆符 (!) が付けられます。

ビューの項目は、デリゲートを使用してレンダリングされます。デフォルトのデリゲート（QStyledItemDelegate ）は、最も一般的なデータ型（int 、QString 、QImageなど）を処理します。デリゲートは、ユーザーがビュー内のアイテムの編集を開始したときに、エディター・ウィジェット（コンボボックスなど）を提供する役割も担っています。QAbstractItemDelegate やQStyledItemDelegate をサブクラス化することで、独自のデリゲートを作成することができます。 詳細はモデル/ビュープログラミングを参照してください。

QSqlTableModel は、一度に一つのテーブルを操作するように最適化されています。任意の結果集合を操作する読み書き可能なモデルが必要な場合は、 をサブクラス化し、 () と () を再実装して読み書き可能にすることができます。以下の2つの関数は、クエリ・モデルのフィールド1と2を編集可能にします：QSqlQueryModel flags setData

Qt::ItemFlags EditableSqlModel::flags(const QModelIndex &index) const
{
    Qt::ItemFlags flags = QSqlQueryModel::flags(index);
    if (index.column() == 1 || index.column() == 2)
        flags |= Qt::ItemIsEditable;
    return flags;
}

bool EditableSqlModel::setData(const QModelIndex &index, const QVariant &value, int /* role */)
{
    if (index.column() < 1 || index.column() > 2)
        return false;

    QModelIndex primaryKeyIndex = QSqlQueryModel::index(index.row(), 0);
    int id = data(primaryKeyIndex).toInt();

    clear();

    bool ok;
    if (index.column() == 1)
        ok = setFirstName(id, value.toString());
    else
        ok = setLastName(id, value.toString());
    refresh();
    return ok;
}

setFirstName() ヘルパー関数は、以下のように定義されています：

bool EditableSqlModel::setFirstName(int personId, const QString &firstName)
{
    QSqlQuery query;
    query.prepare("update person set firstname = ? where id = ?");
    query.addBindValue(firstName);
    query.addBindValue(personId);
    return query.exec();
}

setLastName() 関数も同様です。完全なソースコードはクエリモデルの例を参照してください。

モデルをサブクラス化することで、さまざまな方法でモデルをカスタマイズできるようになります：項目のツールチップを提供したり、背景色を変更したり、計算値を提供したり、表示と編集で異なる値を提供したり、NULL値を特別に扱ったりすることができます。詳細は、QAbstractItemView のリファレンスドキュメントと同様に、モデル/ビュープログラミングを参照してください。

外部キーをより人間に近い文字列に解決するだけであれば、QSqlRelationalTableModel を使用することができます。最良の結果を得るためには、外部キーを編集するためのコンボボックスエディタを提供するデリゲートであるQSqlRelationalDelegate も使用すべきです。

リレーショナル・テーブル・モデルの例では、外部キーをサポートするテーブルを提供するために、QSqlRelationalDelegate と組み合わせてQSqlRelationalTableModel を使用する方法を説明しています。