QDataWidgetMapper Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein neues `QDataWidgetMapper`-Objekt mit dem übergeordneten Objekt ` parent`. Standardmäßig ist die Ausrichtung horizontal und die Übermittlungsrichtlinie lautet ` AutoSubmit`.

Siehe auch setOrientation() und setSubmitPolicy().

[virtual noexcept] QDataWidgetMapper::~QDataWidgetMapper()

Löscht das Objekt.

void QDataWidgetMapper::addMapping(QWidget *widget, int section)

Fügt eine Zuordnung zwischen einem „ widget “ und einem „ section “ aus dem Modell hinzu. „ section “ ist im Modell eine Spalte, wenn die Ausrichtung horizontal ist (Standardeinstellung), andernfalls eine Zeile.

Für das folgende Beispiel nehmen wir ein Modell „ myModel “ an, das zwei Spalten enthält: Die erste Spalte enthält die Namen der Personen in einer Gruppe, die zweite Spalte ihr Alter. Die erste Spalte wird der „ QLineEdit “ ( nameLineEdit) zugeordnet, die zweite der „ QSpinBox “ ( ageSpinBox):

QDataWidgetMapper *mapper = new QDataWidgetMapper;
mapper->setModel(myModel);
mapper->addMapping(nameLineEdit, 0);
mapper->addMapping(ageSpinBox, 1);

Hinweise:

• Wenn das Widget „ widget “ bereits einem Abschnitt zugeordnet ist, wird die alte Zuordnung durch die neue ersetzt.
• Es sind nur Eins-zu-Eins-Zuordnungen zwischen Abschnitten und Widgets zulässig. Es ist nicht möglich, einen einzelnen Abschnitt mehreren Widgets zuzuordnen oder ein einzelnes Widget mehreren Abschnitten zuzuordnen.

Siehe auch removeMapping(), mappedSection() und clearMapping().

void QDataWidgetMapper::addMapping(QWidget *widget, int section, const QByteArray &propertyName)

Im Wesentlichen identisch mit addMapping(), bietet jedoch zusätzlich die Möglichkeit, die zu verwendende Eigenschaft über propertyName anzugeben.

Siehe auch ` addMapping()`.

void QDataWidgetMapper::clearMapping()

Löscht alle Zuordnungen.

Siehe auch addMapping() und removeMapping().

[signal] void QDataWidgetMapper::currentIndexChanged(int index)

Dieses Signal wird ausgelöst, nachdem sich der aktuelle Index geändert hat und alle Widgets mit neuen Daten gefüllt wurden. index ist der neue aktuelle Index.

Siehe auch „ currentIndex()“ und „ setCurrentIndex()“.

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

Gibt den Delegaten des aktuellen Elements zurück.

Siehe auch ` setItemDelegate()`.

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

Gibt den Namen der Eigenschaft zurück, die beim Zuordnen von Daten zur angegebenen „ widget “ verwendet wird.

Siehe auch mappedSection(), addMapping() und removeMapping().

int QDataWidgetMapper::mappedSection(QWidget *widget) const

Gibt den Abschnitt zurück, dem das „ widget “ zugeordnet ist, oder -1, falls das Widget nicht zugeordnet ist.

Siehe auch „ addMapping()“ und „ removeMapping()“.

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

Gibt das Widget zurück, das unter „ section “ zugeordnet ist, oder 0, wenn in diesem Abschnitt kein Widget zugeordnet ist.

Siehe auch addMapping() und removeMapping().

QAbstractItemModel *QDataWidgetMapper::model() const

Gibt das aktuelle Modell zurück.

Siehe auch ` setModel()`.

void QDataWidgetMapper::removeMapping(QWidget *widget)

Entfernt die Zuordnung für die angegebene widget.

Siehe auch addMapping() und clearMapping().

[slot] void QDataWidgetMapper::revert()

Füllt alle Widgets mit den aktuellen Daten des Modells neu. Alle noch nicht gesendeten Änderungen gehen dabei verloren.

Siehe auch submit() und setSubmitPolicy().

QModelIndex QDataWidgetMapper::rootIndex() const

Gibt den aktuellen Stammindex zurück.

Siehe auch „ setRootIndex()“.

[slot] void QDataWidgetMapper::setCurrentModelIndex(const QModelIndex &index)

Setzt den aktuellen Index auf die Zeile des index, wenn die Ausrichtung horizontal ist (Standard), andernfalls auf die Spalte des index.

Ruft intern ` setCurrentIndex()` auf. Dieser Komfort-Slot kann mit dem Signal ` currentRowChanged()` oder ` currentColumnChanged()` des ` selection model` einer anderen Ansicht verbunden werden.

Das folgende Beispiel veranschaulicht, wie alle Widgets mit neuen Daten aktualisiert werden, sobald sich die Auswahl eines „ QTableView “ namens „ myTableView “ ändert:

QDataWidgetMapper *mapper = new QDataWidgetMapper;
connect(myTableView->selectionModel(), &QItemSelectionModel::currentRowChanged,
        mapper, &QDataWidgetMapper::setCurrentModelIndex);

Siehe auch ` currentIndex()` ().

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

Legt den Element-Delegaten auf „ delegate “ fest. Der Delegat wird verwendet, um Daten aus dem Modell in das Widget und aus dem Widget in das Modell zu schreiben, und zwar mithilfe von „ QAbstractItemDelegate::setEditorData()“ und „ QAbstractItemDelegate::setModelData()“.

Ein eventuell vorhandener Delegat wird entfernt, jedoch nicht gelöscht. QDataWidgetMapper übernimmt nicht die Eigentümerschaft an delegate.

Der Delegat entscheidet zudem mithilfe von ` QAbstractItemDelegate::commitData()` und ` QAbstractItemDelegate::closeEditor()`, wann Daten angewendet und wann der Editor geändert werden soll.

Siehe auch ` itemDelegate()`.

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

Setzt das aktuelle Modell auf „ model “. Wenn zuvor ein anderes Modell festgelegt war, werden alle Zuordnungen zu diesem alten Modell gelöscht.

Siehe auch ` model()`.

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

Setzt das Stammelement auf „ index “. Dies kann verwendet werden, um einen Zweig eines Baums anzuzeigen. Übergeben Sie einen ungültigen Modellindex, um den obersten Zweig anzuzeigen.

Siehe auch rootIndex().

[slot] bool QDataWidgetMapper::submit()

Übermittelt alle Änderungen aus den zugeordneten Widgets an das Modell.

Für jeden zugeordneten Abschnitt liest der Item-Delegat den aktuellen Wert aus dem Widget aus und setzt ihn im Modell. Abschließend wird die Methode „ submit()“ des Modells aufgerufen.

Gibt ` true ` zurück, wenn alle Werte übermittelt wurden, andernfalls `false`.

Hinweis: Bei Datenbankmodellen kann ` QSqlQueryModel::lastError()` verwendet werden, um den letzten Fehler abzurufen.

Siehe auch ` revert()` und ` setSubmitPolicy()`.

[slot] void QDataWidgetMapper::toFirst()

Füllt die Widgets mit Daten aus der ersten Zeile des Modells, wenn die Ausrichtung horizontal ist (Standardeinstellung), andernfalls mit Daten aus der ersten Spalte.

Dies entspricht dem Aufruf von ` setCurrentIndex(0)`.

Siehe auch „ toLast()“ und „ setCurrentIndex()“.

[slot] void QDataWidgetMapper::toLast()

Füllt die Widgets mit Daten aus der letzten Zeile des Modells, wenn die Ausrichtung horizontal ist (Standard), andernfalls mit Daten aus der letzten Spalte.

Ruft intern ` setCurrentIndex()` auf.

Siehe auch ` toFirst()` und ` setCurrentIndex()`.

[slot] void QDataWidgetMapper::toNext()

Füllt die Widgets mit Daten aus der nächsten Zeile des Modells, wenn die Ausrichtung horizontal ist (Standardeinstellung), andernfalls mit Daten aus der nächsten Spalte.

Ruft intern ` setCurrentIndex()` auf. Führt keine Aktion aus, wenn im Modell keine nächste Zeile vorhanden ist.

Siehe auch ` toPrevious()` und ` setCurrentIndex()`.

[slot] void QDataWidgetMapper::toPrevious()

Füllt die Widgets mit Daten aus der vorherigen Zeile des Modells, wenn die Ausrichtung horizontal ist (Standardeinstellung), andernfalls mit Daten aus der vorherigen Spalte.

Ruft intern ` setCurrentIndex()` auf. Führt keine Aktion aus, wenn im Modell keine vorherige Zeile vorhanden ist.

Siehe auch ` toNext()` und ` setCurrentIndex()`.