QDataWidgetMapper Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen neuen QDataWidgetMapper 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()

Zerstört das Objekt.

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

Fügt ein Mapping zwischen einem widget und einem section aus dem Modell hinzu. section ist eine Spalte im Modell, wenn die Ausrichtung horizontal ist (Standard), ansonsten eine Zeile.

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

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

Anmerkungen:

• Wenn die 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 dasselbe wie addMapping(), jedoch mit der zusätzlichen Möglichkeit, die zu verwendende Eigenschaft durch Angabe von propertyName anzugeben.

Siehe auch addMapping().

void QDataWidgetMapper::clearMapping()

Löscht alle Mappings.

Siehe auch addMapping() und removeMapping().

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

Dieses Signal wird ausgegeben, nachdem sich der aktuelle Index geändert hat und alle Widgets mit neuen Daten bestückt wurden. index ist der neue aktuelle Index.

Siehe auch currentIndex() und setCurrentIndex().

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

Gibt den aktuellen Elementdelegierten zurück.

Siehe auch setItemDelegate().

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

Gibt den Namen der Eigenschaft zurück, die bei der Zuordnung von Daten zu der angegebenen widget verwendet wird.

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

int QDataWidgetMapper::mappedSection(QWidget *widget) const

Gibt den Bereich zurück, dem das widget zugeordnet ist, oder -1, wenn das Widget nicht zugeordnet ist.

Siehe auch addMapping() und removeMapping().

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

Gibt das Widget zurück, das unter section abgebildet ist, oder 0, wenn kein Widget in diesem Abschnitt abgebildet 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 das Mapping 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 auf. Alle nicht übermittelten Änderungen gehen dabei verloren.

Siehe auch submit() und setSubmitPolicy().

QModelIndex QDataWidgetMapper::rootIndex() const

Gibt den aktuellen Wurzelindex 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 (die Vorgabe), andernfalls auf die Spalte des index.

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

Das folgende Beispiel zeigt, wie alle Widgets mit neuen Daten aktualisiert werden, wenn 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)

Setzt den Elementdelegaten auf delegate. Der Delegat wird verwendet, um Daten aus dem Modell in das Widget und aus dem Widget in das Modell zu schreiben, unter Verwendung von QAbstractItemDelegate::setEditorData() und QAbstractItemDelegate::setModelData().

Jeder existierende Delegat wird entfernt, aber nicht gelöscht. QDataWidgetMapper übernimmt nicht den Besitz von delegate.

Der Delegat entscheidet auch, wann er Daten anwendet und wann er den Editor ändert, indem er QAbstractItemDelegate::commitData() und QAbstractItemDelegate::closeEditor() verwendet.

Siehe auch itemDelegate().

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

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

Siehe auch model().

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

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

Siehe auch rootIndex().

[slot] bool QDataWidgetMapper::submit()

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

Für jeden zugeordneten Abschnitt liest der Item-Delegierte den aktuellen Wert aus dem Widget und setzt ihn im Modell. Schließlich 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 (Standard), ansonsten mit Daten aus der ersten Spalte.

Dies ist gleichbedeutend mit 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), ansonsten 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 (Standard), ansonsten mit Daten aus der nächsten Spalte.

Ruft intern setCurrentIndex() auf. Tut nichts, wenn es keine nächste Zeile im Modell gibt.

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), ansonsten mit Daten aus der vorherigen Spalte.

Ruft intern setCurrentIndex() auf. Führt nichts aus, wenn es keine vorherige Zeile im Modell gibt.

Siehe auch toNext() und setCurrentIndex().