QDataWidgetMapper Class

Documentación de funciones miembro

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

Construye un nuevo QDataWidgetMapper con el objeto padre parent. Por defecto, la orientación es horizontal y la política de envío es AutoSubmit.

Ver también setOrientation() y setSubmitPolicy().

[virtual noexcept] QDataWidgetMapper::~QDataWidgetMapper()

Destruye el objeto.

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

Añade una correspondencia entre un widget y un section del modelo. El section es una columna del modelo si la orientación es horizontal (por defecto), en caso contrario es una fila.

Para el siguiente ejemplo, suponemos un modelo myModel que tiene dos columnas: la primera contiene los nombres de las personas de un grupo, y la segunda, sus edades. La primera columna se asigna a QLineEdit nameLineEdit , y la segunda a QSpinBox ageSpinBox :

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

Notas:

• Si widget ya está asignada a una sección, la antigua asignación será sustituida por la nueva.
• Sólo se permiten asignaciones uno a uno entre secciones y widgets. No es posible asignar una sección a varios widgets, ni asignar un widget a varias secciones.

Véase también removeMapping(), mappedSection() y clearMapping().

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

Esencialmente lo mismo que addMapping(), pero añade la posibilidad de especificar la propiedad a utilizar especificando propertyName.

Véase también addMapping().

void QDataWidgetMapper::clearMapping()

Borra todas las asignaciones.

Véase también addMapping() y removeMapping().

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

Esta señal se emite después de que el índice actual haya cambiado y todos los widgets se hayan rellenado con nuevos datos. index es el nuevo índice actual.

Véase también currentIndex() y setCurrentIndex().

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

Devuelve el delegado de elemento actual.

Véase también setItemDelegate().

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

Devuelve el nombre de la propiedad que se utiliza al asignar datos a la dirección widget.

Véase también mappedSection(), addMapping() y removeMapping().

int QDataWidgetMapper::mappedSection(QWidget *widget) const

Devuelve la sección a la que está asignado widget o -1 si el widget no está asignado.

Véase también addMapping() y removeMapping().

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

Devuelve el widget que está mapeado en section, o 0 si no hay ningún widget mapeado en esa sección.

Véase también addMapping() y removeMapping().

QAbstractItemModel *QDataWidgetMapper::model() const

Devuelve el modelo actual.

Véase también setModel().

void QDataWidgetMapper::removeMapping(QWidget *widget)

Elimina la asignación de la dirección widget.

Véase también addMapping() y clearMapping().

[slot] void QDataWidgetMapper::revert()

Rellena todos los widgets con los datos actuales del modelo. Todos los cambios no enviados se perderán.

Véase también submit() y setSubmitPolicy().

QModelIndex QDataWidgetMapper::rootIndex() const

Devuelve el índice raíz actual.

Véase también setRootIndex().

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

Establece el índice actual en la fila de index si la orientación es horizontal (por defecto), en caso contrario en la columna de index.

Llama internamente a setCurrentIndex(). Esta ranura de conveniencia puede conectarse a la señal currentRowChanged() o currentColumnChanged() de otra vista selection model.

El siguiente ejemplo ilustra cómo actualizar todos los widgets con nuevos datos cada vez que cambia la selección de un QTableView llamado myTableView:

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

Véase también currentIndex().

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

Establece el delegado de elemento en delegate. El delegado se utilizará para escribir datos del modelo en el widget y del widget en el modelo, utilizando QAbstractItemDelegate::setEditorData() y QAbstractItemDelegate::setModelData().

Cualquier delegado existente será eliminado, pero no borrado. QDataWidgetMapper no se apropia de delegate.

El delegado también decide cuándo aplicar datos y cuándo cambiar el editor, utilizando QAbstractItemDelegate::commitData() y QAbstractItemDelegate::closeEditor().

Véase también itemDelegate().

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

Establece el modelo actual en model. Si se estableció otro modelo, se borran todas las asignaciones a ese modelo antiguo.

Véase también model().

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

Establece el elemento raíz en index. Esto se puede utilizar para mostrar una rama de un árbol. Pase un índice de modelo no válido para mostrar la rama superior.

Véase también rootIndex().

[slot] bool QDataWidgetMapper::submit()

Envía todos los cambios de los widgets mapeados al modelo.

Para cada sección asignada, el delegado de elementos lee el valor actual del widget y lo establece en el modelo. Por último, se invoca el método submit() del modelo.

Devuelve true si se han enviado todos los valores, en caso contrario false.

Nota: Para los modelos de base de datos, QSqlQueryModel::lastError() se puede utilizar para recuperar el último error.

Véase también revert() y setSubmitPolicy().

[slot] void QDataWidgetMapper::toFirst()

Rellena los widgets con los datos de la primera fila del modelo si la orientación es horizontal (por defecto); en caso contrario, con los datos de la primera columna.

Esto equivale a llamar a setCurrentIndex(0).

Véase también toLast() y setCurrentIndex().

[slot] void QDataWidgetMapper::toLast()

Rellena los widgets con los datos de la última fila del modelo si la orientación es horizontal (por defecto), en caso contrario con los datos de la última columna.

Llama internamente a setCurrentIndex().

Véase también toFirst() y setCurrentIndex().

[slot] void QDataWidgetMapper::toNext()

Rellena los widgets con datos de la siguiente fila del modelo si la orientación es horizontal (por defecto), en caso contrario con datos de la siguiente columna.

Llama internamente a setCurrentIndex(). No hace nada si no hay siguiente fila en el modelo.

Véase también toPrevious() y setCurrentIndex().

[slot] void QDataWidgetMapper::toPrevious()

Rellena los widgets con los datos de la fila anterior del modelo si la orientación es horizontal (por defecto), en caso contrario con los datos de la columna anterior.

Llama internamente a setCurrentIndex(). No hace nada si no hay fila anterior en el modelo.

Véase también toNext() y setCurrentIndex().