QDataWidgetMapper Class

Documentation des fonctions membres

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

Construit un nouveau QDataWidgetMapper avec l'objet parent parent. Par défaut, l'orientation est horizontale et la politique de soumission est AutoSubmit.

Voir également setOrientation() et setSubmitPolicy().

[virtual noexcept] QDataWidgetMapper::~QDataWidgetMapper()

Détruit l'objet.

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

Ajoute une correspondance entre un widget et un section du modèle. Le section est une colonne du modèle si l'orientation est horizontale (par défaut), sinon une ligne.

Dans l'exemple suivant, nous supposons que le modèle myModel comporte deux colonnes : la première contient les noms des personnes d'un groupe et la seconde leur âge. La première colonne est mappée sur QLineEdit nameLineEdit , et la seconde sur QSpinBox ageSpinBox :

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

Remarques :

• Si le site widget est déjà associé à une section, l'ancienne correspondance sera remplacée par la nouvelle.
• Seules les correspondances biunivoques entre les sections et les widgets sont autorisées. Il n'est pas possible d'associer une section à plusieurs widgets, ni un widget à plusieurs sections.

Voir également removeMapping(), mappedSection() et clearMapping().

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

Essentiellement la même chose que addMapping(), mais ajoute la possibilité de spécifier la propriété à utiliser en spécifiant propertyName.

Voir également addMapping().

void QDataWidgetMapper::clearMapping()

Efface toutes les correspondances.

Voir aussi addMapping() et removeMapping().

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

Ce signal est émis après que l'index courant a changé et que tous les widgets ont été remplis avec de nouvelles données. index est le nouvel index courant.

Voir aussi currentIndex() et setCurrentIndex().

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

Renvoie le délégué de l'élément actuel.

Voir aussi setItemDelegate().

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

Renvoie le nom de la propriété utilisée lors de la mise en correspondance des données avec l'adresse widget.

Voir aussi mappedSection(), addMapping() et removeMapping().

int QDataWidgetMapper::mappedSection(QWidget *widget) const

Renvoie la section à laquelle le widget est rattaché ou -1 si le widget n'est pas rattaché.

Voir aussi addMapping() et removeMapping().

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

Renvoie le widget qui est mappé à section, ou 0 si aucun widget n'est mappé à cette section.

Voir aussi addMapping() et removeMapping().

QAbstractItemModel *QDataWidgetMapper::model() const

Renvoie le modèle actuel.

Voir aussi setModel().

void QDataWidgetMapper::removeMapping(QWidget *widget)

Supprime le mappage pour l'adresse widget donnée.

Voir aussi addMapping() et clearMapping().

[slot] void QDataWidgetMapper::revert()

Remplit tous les widgets avec les données actuelles du modèle. Toutes les modifications non soumises seront perdues.

Voir aussi submit() et setSubmitPolicy().

QModelIndex QDataWidgetMapper::rootIndex() const

Renvoie l'index actuel de la racine.

Voir aussi setRootIndex().

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

Fixe l'index actuel à la ligne de index si l'orientation est horizontale (par défaut), sinon à la colonne de index.

Appelle setCurrentIndex() en interne. Ce slot de commodité peut être connecté au signal currentRowChanged() ou currentColumnChanged() d'une autre vue selection model.

L'exemple suivant illustre comment mettre à jour tous les widgets avec de nouvelles données lorsque la sélection d'un QTableView nommé myTableView change :

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

Voir aussi currentIndex().

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

Définit le délégué de l'élément à delegate. Le délégué sera utilisé pour écrire les données du modèle dans le widget et du widget vers le modèle, en utilisant QAbstractItemDelegate::setEditorData() et QAbstractItemDelegate::setModelData().

Tout délégué existant sera supprimé, mais pas effacé. QDataWidgetMapper n'est pas propriétaire de delegate.

Le délégué décide également quand appliquer les données et quand changer l'éditeur, en utilisant QAbstractItemDelegate::commitData() et QAbstractItemDelegate::closeEditor().

Voir également itemDelegate().

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

Définit le modèle actuel à model. Si un autre modèle a été défini, toutes les correspondances avec l'ancien modèle sont effacées.

Voir aussi model().

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

Définit l'élément racine à index. Ceci peut être utilisé pour afficher une branche d'un arbre. Passer un index de modèle invalide pour afficher la branche la plus haute.

Voir aussi rootIndex().

[slot] bool QDataWidgetMapper::submit()

Soumet toutes les modifications apportées par les widgets mappés au modèle.

Pour chaque section mappée, le délégué de l'élément lit la valeur actuelle du widget et la définit dans le modèle. Enfin, la méthode submit() du modèle est invoquée.

Elle renvoie true si toutes les valeurs ont été soumises, sinon elle renvoie false.

Remarque : pour les modèles de base de données, QSqlQueryModel::lastError() peut être utilisé pour récupérer la dernière erreur.

Voir également revert() et setSubmitPolicy().

[slot] void QDataWidgetMapper::toFirst()

Remplit les widgets avec les données de la première ligne du modèle si l'orientation est horizontale (par défaut), sinon avec les données de la première colonne.

Cela équivaut à appeler setCurrentIndex(0).

Voir également toLast() et setCurrentIndex().

[slot] void QDataWidgetMapper::toLast()

Remplit les widgets avec les données de la dernière ligne du modèle si l'orientation est horizontale (par défaut), sinon avec les données de la dernière colonne.

Appelle setCurrentIndex() en interne.

Voir aussi toFirst() et setCurrentIndex().

[slot] void QDataWidgetMapper::toNext()

Remplit les widgets avec les données de la ligne suivante du modèle si l'orientation est horizontale (par défaut), sinon avec les données de la colonne suivante.

Appelle setCurrentIndex() en interne. Ne fait rien s'il n'y a pas de ligne suivante dans le modèle.

Voir aussi toPrevious() et setCurrentIndex().

[slot] void QDataWidgetMapper::toPrevious()

Remplit les widgets avec les données de la ligne précédente du modèle si l'orientation est horizontale (par défaut), sinon avec les données de la colonne précédente.

Appelle setCurrentIndex() en interne. Ne fait rien s'il n'y a pas de ligne précédente dans le modèle.

Voir aussi toNext() et setCurrentIndex().