QDataWidgetMapper Class

Documentation des fonctions membres

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

Crée un nouvel objet `QDataWidgetMapper` dont l'objet parent est ` parent`. Par défaut, l'orientation est horizontale et la politique de validation 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 une « widget » et une « section » du modèle. L’« section » est une colonne du modèle si l’orientation est horizontale (par défaut), sinon c’est une ligne.

Dans l’exemple suivant, nous partons du principe 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 mise en correspondance avec l’ QLineEdit nameLineEdit , et la seconde avec l’ QSpinBox ageSpinBox :

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

Remarques :

• Si l’ widget est déjà associé à une section, l’ancien mappage sera remplacé par le nouveau.
• Seuls les mappages biunivoques entre sections et widgets sont autorisés. Il n’est pas possible de mapper une seule section à plusieurs widgets, ni de mapper un seul widget à plusieurs sections.

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

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

Cette méthode est pratiquement identique à addMapping(), mais offre en plus la possibilité de spécifier la propriété à utiliser en indiquant propertyName.

Voir également addMapping().

void QDataWidgetMapper::clearMapping()

Efface tous les mappages.

Voir également addMapping() et removeMapping().

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

Ce signal est émis une fois que l'index actuel a changé et que tous les widgets ont été mis à jour avec les nouvelles données. index correspond au nouvel index actuel.

Voir également 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 du mappage des données vers l'widget donné.

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

int QDataWidgetMapper::mappedSection(QWidget *widget) const

Renvoie la section à laquelle le widget « widget » est associé, ou -1 si le widget n'est pas associé.

Voir aussi ` addMapping()` et ` removeMapping()`.

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

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

Voir également addMapping() et removeMapping().

QAbstractItemModel *QDataWidgetMapper::model() const

Renvoie le modèle actuel.

Voir aussi setModel().

void QDataWidgetMapper::removeMapping(QWidget *widget)

Supprime le mappage associé à l'widget.

Voir également addMapping() et clearMapping().

[slot] void QDataWidgetMapper::revert()

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

Voir également submit() et setSubmitPolicy().

QModelIndex QDataWidgetMapper::rootIndex() const

Renvoie l'index racine actuel.

Voir également ` setRootIndex()`.

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

Définit l'index courant sur la ligne de l'index si l'orientation est horizontale (par défaut), sinon sur la colonne de l'index.

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

L’exemple suivant illustre comment mettre à jour tous les widgets avec de nouvelles données chaque fois que la sélection d’un « QTableView » nommé « myTableView » change :

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

Voir également currentIndex().

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

Définit le délégué de l'élément sur delegate. Ce délégué sera utilisé pour écrire les données du modèle dans le widget et celles du widget dans le modèle, à l'aide des méthodes QAbstractItemDelegate::setEditorData() et QAbstractItemDelegate::setModelData().

Tout délégué existant sera retiré, mais non supprimé. QDataWidgetMapper ne prend pas possession de delegate.

Le délégué décide également quand appliquer les données et quand changer d’éditeur, à l’aide de QAbstractItemDelegate::commitData() et QAbstractItemDelegate::closeEditor().

Voir également ` itemDelegate()`.

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

Définit le modèle actuel sur model. Si un autre modèle avait été défini, tous les mappages vers cet ancien modèle sont effacés.

Voir également model().

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

Définit l'élément racine sur index. Cette fonction peut être utilisée pour afficher une branche d'une arborescence. Passez un index de modèle non valide pour afficher la branche la plus haute.

Voir également rootIndex().

[slot] bool QDataWidgetMapper::submit()

Envoie toutes les modifications provenant des widgets mappés vers le modèle.

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

Renvoie ` true ` si toutes les valeurs ont été soumises, sinon `false`.

Remarque : pour les modèles de base de données, la méthode QSqlQueryModel::lastError() peut être utilisée 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 celles de la première colonne.

Cela revient à 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 celles de la dernière colonne.

Appelle en interne la fonction setCurrentIndex().

Voir également 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 celles de la colonne suivante.

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

Voir également 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 celles de la colonne précédente.

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

Voir également toNext() et setCurrentIndex().