QDataWidgetMapper Class

成员函数文档

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

创建一个以parent 为父对象的新QDataWidgetMapper。默认情况下，其方向为水平，提交策略为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 所映射的段落，如果该控件未被映射，则返回-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()。