QSqlQueryModel Class

Dokumentation der Mitgliedsfunktionen

[explicit] QSqlQueryModel::QSqlQueryModel(QObject *parent = nullptr)

Erzeugt ein leeres QSqlQueryModel mit der angegebenen parent.

[virtual noexcept] QSqlQueryModel::~QSqlQueryModel()

Zerstört das Objekt und gibt alle zugewiesenen Ressourcen frei.

Siehe auch clear().

[override virtual] bool QSqlQueryModel::canFetchMore(const QModelIndex &parent = QModelIndex()) const

Reimplements: QAbstractItemModel::canFetchMore(const QModelIndex &parent) const.

Gibt true zurück, wenn es möglich ist, weitere Zeilen aus der Datenbank zu lesen. Dies betrifft nur Datenbanken, die die Größe einer Abfrage nicht zurückmelden (siehe QSqlDriver::hasFeature()).

parent sollte immer ein ungültiger QModelIndex sein.

Siehe auch fetchMore().

[virtual] void QSqlQueryModel::clear()

Löscht das Modell und gibt alle erworbenen Ressourcen frei.

[override virtual] int QSqlQueryModel::columnCount(const QModelIndex &index = QModelIndex()) const

Reimplements: QAbstractItemModel::columnCount(const QModelIndex &parent) const.

[override virtual] QVariant QSqlQueryModel::data(const QModelIndex &item, int role = Qt::DisplayRole) const

Reimplements: QAbstractItemModel::data(const QModelIndex &index, int role) const.

Gibt den Wert für die angegebenen item und role zurück.

Wenn item außerhalb der Grenzen liegt oder ein Fehler auftritt, wird ein ungültiger QVariant zurückgegeben.

Siehe auch lastError().

[override virtual] void QSqlQueryModel::fetchMore(const QModelIndex &parent = QModelIndex())

Reimplements: QAbstractItemModel::fetchMore(const QModelIndex &parent).

Holt mehr Zeilen aus einer Datenbank. Dies betrifft nur Datenbanken, die die Größe einer Abfrage nicht zurückmelden (siehe QSqlDriver::hasFeature()).

Um das Abrufen der gesamten Ergebnismenge zu erzwingen, können Sie Folgendes verwenden:

while (myModel->canFetchMore())
    myModel->fetchMore();

parent sollte immer eine ungültige QModelIndex sein.

Siehe auch canFetchMore().

[override virtual] QVariant QSqlQueryModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

Reimplements: QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

Liefert die Kopfdaten für das angegebene role in der section des Headers mit dem angegebenen orientation.

Siehe auch setHeaderData().

[virtual protected] QModelIndex QSqlQueryModel::indexInQuery(const QModelIndex &item) const

Gibt den Index des Wertes in der Datenbankergebnismenge für die angegebene item im Modell zurück.

Der Rückgabewert ist identisch mit item, wenn keine Spalten oder Zeilen eingefügt, entfernt oder verschoben wurden.

Gibt einen ungültigen Modellindex zurück, wenn item außerhalb der Grenzen liegt oder wenn item nicht auf einen Wert in der Ergebnismenge zeigt.

Siehe auch QSqlTableModel::indexInQuery(), insertColumns(), und removeColumns().

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

Reimplements: QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

Fügt count Spalten an der Position column in das Modell ein. Der Parameter parent muss immer ein ungültiger QModelIndex sein, da das Modell keine Eltern-Kind-Beziehungen unterstützt.

Gibt true zurück, wenn column innerhalb der Grenzen liegt; andernfalls wird false zurückgegeben.

Standardmäßig sind die eingefügten Spalten leer. Um sie mit Daten zu füllen, reimplementieren Sie data() und behandeln jede eingefügte Spalte separat:

QVariant MyModel::data(const QModelIndex &item, int role) const
{
    if (item.column() == m_specialColumnNo) {
        // handle column separately
    }
    return QSqlQueryModel::data(item, role);
}

Siehe auch removeColumns().

QSqlError QSqlQueryModel::lastError() const

Liefert Informationen über den letzten Fehler, der in der Datenbank aufgetreten ist.

Siehe auch setLastError() und query().

const QSqlQuery &QSqlQueryModel::query() const

Gibt einen Verweis auf das mit diesem Modell verbundene Objekt const QSqlQuery zurück.

Siehe auch setQuery().

[virtual protected] void QSqlQueryModel::queryChange()

Diese virtuelle Funktion wird immer dann aufgerufen, wenn sich die Abfrage ändert. Die Standardimplementierung tut nichts.

query() gibt die neue Abfrage zurück.

Siehe auch query() und setQuery().

QSqlRecord QSqlQueryModel::record(int row) const

Gibt den Datensatz zurück, der Informationen über die Felder der aktuellen Abfrage enthält. Wenn row der Index einer gültigen Zeile ist, wird der Datensatz mit Werten aus dieser Zeile gefüllt.

Wenn das Modell nicht initialisiert ist, wird ein leerer Datensatz zurückgegeben.

Siehe auch QSqlRecord::isEmpty().

QSqlRecord QSqlQueryModel::record() const

Dies ist eine überladene Funktion.

Gibt einen leeren Datensatz zurück, der Informationen über die Felder der aktuellen Abfrage enthält.

Wenn das Modell nicht initialisiert ist, wird ein leerer Datensatz zurückgegeben.

Siehe auch QSqlRecord::isEmpty().

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

Reimplements: QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

Entfernt count Spalten aus dem Modell ab der Position column. Der Parameter parent muss immer ein ungültiger QModelIndex sein, da das Modell keine Eltern-Kind-Beziehungen unterstützt.

Das Entfernen von Spalten blendet diese effektiv aus. Die zugrunde liegende QSqlQuery bleibt davon unberührt.

Gibt true zurück, wenn die Spalten entfernt wurden; andernfalls wird false zurückgegeben.

[override virtual] QHash<int, QByteArray> QSqlQueryModel::roleNames() const

Reimplements: QAbstractItemModel::roleNames() const.

Gibt die Rollennamen des Modells zurück.

Qt definiert nur eine Rolle für die QSqlQueryModel:

[override virtual] int QSqlQueryModel::rowCount(const QModelIndex &parent = QModelIndex()) const

Reimplements: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Wenn die Datenbank die Rückgabe der Größe einer Abfrage unterstützt (siehe QSqlDriver::hasFeature()), wird die Anzahl der Zeilen der aktuellen Abfrage zurückgegeben. Andernfalls wird die Anzahl der aktuell auf dem Client zwischengespeicherten Zeilen zurückgegeben.

parent sollte immer ein ungültiges QModelIndex sein.

Siehe auch canFetchMore() und QSqlDriver::hasFeature().

[override virtual] bool QSqlQueryModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

Reimplements: QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Setzt die Beschriftung für eine horizontale Kopfzeile für die angegebene role auf value. Dies ist nützlich, wenn das Modell zur Anzeige von Daten in einer Ansicht verwendet wird (z.B. QTableView).

Gibt true zurück, wenn orientation Qt::Horizontal ist und sich section auf einen gültigen Abschnitt bezieht; andernfalls wird false zurückgegeben.

Beachten Sie, dass diese Funktion nicht verwendet werden kann, um Werte in der Datenbank zu ändern, da das Modell schreibgeschützt ist.

Siehe auch headerData() und data().

[protected] void QSqlQueryModel::setLastError(const QSqlError &error)

Geschützte Funktion, die es abgeleiteten Klassen ermöglicht, den Wert des letzten Fehlers, der in der Datenbank aufgetreten ist, auf error zu setzen.

Siehe auch lastError().

[since 6.2] void QSqlQueryModel::setQuery(QSqlQuery &&query)

Setzt das Modell zurück und setzt den Datenanbieter auf den angegebenen query. Beachten Sie, dass die Abfrage aktiv sein muss und nicht isForwardOnly() sein darf.

lastError() kann verwendet werden, um ausführliche Informationen abzurufen, wenn ein Fehler beim Setzen der Abfrage aufgetreten ist.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch query(), QSqlQuery::isActive(), QSqlQuery::setForwardOnly(), und lastError().

void QSqlQueryModel::setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase())

Dies ist eine überladene Funktion.

Führt die Abfrage query für die angegebene Datenbankverbindung db aus. Wenn keine Datenbank (oder eine ungültige Datenbank) angegeben wird, wird die Standardverbindung verwendet.

lastError() kann verwendet werden, um ausführliche Informationen abzurufen, wenn beim Setzen der Abfrage ein Fehler aufgetreten ist.

Beispiel:

QSqlQueryModel model; model.setQuery("select * from MyTable");if (model.lastError().isValid())    qDebug() << model.lastError();

Siehe auch query(), queryChange(), und lastError().