QDataWidgetMapper Class

成员函数文档

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

构造一个新的 QDataWidgetMapper，其父对象为parent 。默认情况下，方向为水平，提交策略为AutoSubmit 。

另请参阅 setOrientation() 和setSubmitPolicy() 。

[virtual noexcept] QDataWidgetMapper::~QDataWidgetMapper()

销毁对象。

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

添加模型中widget 和section 之间的映射。如果section 的方向是水平的（默认），它就是模型中的一列，否则就是一行。

在下面的示例中，我们假设模型myModel 有两列：第一列包含一个组中人的姓名，第二列包含他们的年龄。第一列映射到QLineEdit nameLineEdit ，第二列映射到QSpinBox ageSpinBox ：

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

注：

• 如果widget 已经映射到一个部分，旧的映射将被新的映射取代。
• 节和部件之间只允许一对一的映射。不能将一个部分映射到多个部件，也不能将一个部件映射到多个部分。

另请参见 removeMapping()、mappedSection() 和clearMapping()。

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

本质上与 addMapping() 相同，但增加了使用propertyName 指定属性的可能性。

另请参阅 addMapping() 。

void QDataWidgetMapper::clearMapping()

清除所有映射。

另请参阅 addMapping() 和removeMapping()。

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

index 是新的当前索引。

另请参阅 currentIndex() 和setCurrentIndex()。

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

返回当前项目委托。

另请参阅 setItemDelegate()。

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

返回将数据映射到给定widget 时使用的属性名称。

另请参阅 mappedSection()、addMapping() 和removeMapping()。

int QDataWidgetMapper::mappedSection(QWidget *widget) const

返回widget 映射到的部分，如果未映射到 widget，则返回-1。

另请参阅 addMapping() 和removeMapping()。

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

返回映射到section 的部件，如果该部分没有映射部件，则返回 0。

另请参阅 addMapping() 和removeMapping()。

QAbstractItemModel *QDataWidgetMapper::model() const

返回当前模型。

另请参见 setModel()。

void QDataWidgetMapper::removeMapping(QWidget *widget)

删除给定widget 的映射。

另请参阅 addMapping() 和clearMapping()。

[slot] void QDataWidgetMapper::revert()

用模型的当前数据重新填充所有部件。所有未提交的更改都将丢失。

另请参阅 submit() 和setSubmitPolicy()。

QModelIndex QDataWidgetMapper::rootIndex() const

返回当前根索引。

另请参见 setRootIndex()。

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

如果方向为水平（默认），则将当前索引设置为index 的行，否则设置为index 的列。

内部调用setCurrentIndex() 。此方便槽可连接到另一个视图的selection model 的信号currentRowChanged() 或currentColumnChanged() 。

下面的示例说明了每当名为myTableView 的QTableView 的选择发生变化时，如何用新数据更新所有部件：

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

另请参阅 currentIndex() 。

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

将项目委托设置为delegate 。该委托将用于使用QAbstractItemDelegate::setEditorData() 和QAbstractItemDelegate::setModelData() 将数据从模型写入部件，以及从部件写入模型。

QDataWidgetMapper 不拥有delegate 的所有权。

该委托还使用QAbstractItemDelegate::commitData() 和QAbstractItemDelegate::closeEditor() 决定何时应用数据和何时更改编辑器。

另请参阅 itemDelegate()。

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

将当前模型设置为model 。如果已设置了另一个模型，则会清除与该旧模型的所有映射。

另请参阅 model() 。

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

将根项设置为index 。这可用于显示树的一个分支。传递一个无效的模型索引可显示最顶端的分支。

另请参阅 rootIndex() 。

[slot] bool QDataWidgetMapper::submit()

将映射部件的所有更改提交给模型。

对于每个映射部分，项目委托都会从部件读取当前值并将其设置到模型中。最后，调用模型的submit() 方法。

如果所有值都已提交，则返回true ，否则返回 false。

注：对于数据库模型，QSqlQueryModel::lastError() 可用于检索最后一个错误。

另请参阅 revert() 和setSubmitPolicy()。

[slot] void QDataWidgetMapper::toFirst()

如果方向是水平的（默认），则使用模型第一行的数据填充部件，否则使用第一列的数据填充部件。

这相当于调用setCurrentIndex(0) 。

另请参阅 toLast() 和setCurrentIndex()。

[slot] void QDataWidgetMapper::toLast()

如果方向为水平（默认），则使用模型最后一行的数据填充部件，否则使用最后一列的数据填充部件。

内部调用setCurrentIndex()。

另请参见 toFirst() 和setCurrentIndex()。

[slot] void QDataWidgetMapper::toNext()

如果方向是水平的（默认），则使用模型下一行的数据填充部件，否则使用下一列的数据填充部件。

内部调用setCurrentIndex()如果模型中没有下一行，则不做任何操作。

另请参见 toPrevious() 和setCurrentIndex()。

[slot] void QDataWidgetMapper::toPrevious()

如果方向为水平（默认），则使用模型前一行的数据填充部件，否则使用前一列的数据填充部件。

内部调用setCurrentIndex()如果模型中没有前一行，则不做任何操作。

另请参见 toNext() 和setCurrentIndex()。