QDataWidgetMapper 类

成员函数文档

[显式] 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);

注意

• 如果 部件 已映射到某个部分，则旧映射将被新映射替换。
• 允许部分和部件之间的一对一映射。不能将单个部分映射到多个部件，也不能将单个部件映射到多个部分。

另请参阅 removeMapping()，mappedSection() 和 clearMapping()。

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

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

另请参阅 addMapping()。

void QDataWidgetMapper::clearMapping()

清除所有映射。

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

[信号] 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().

[槽] void QDataWidgetMapper::revert()

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

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

QModelIndex QDataWidgetMapper::rootIndex() const

返回当前根索引。

另请参阅setRootIndex().

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

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

内部调用 setCurrentIndex()。这个便利槽可以连接到另一个视图的 选择模型 的 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。