QStyledItemDelegate Class

Description détaillée

Lors de l'affichage de données provenant de modèles dans des vues d'éléments Qt, par exemple, un QTableView, les éléments individuels sont dessinés par un délégué. De plus, lorsqu'un élément est modifié, il fournit un widget d'éditeur, qui est placé au-dessus de la vue de l'élément pendant la modification. QStyledItemDelegate est le délégué par défaut de toutes les vues d'éléments de Qt et est installé sur celles-ci lorsqu'elles sont créées.

La classe QStyledItemDelegate est l'une des classes Modèle/Vue et fait partie du cadre Modèle/Vue de Qt. Le délégué permet de développer l'affichage et l'édition des éléments indépendamment du modèle et de la vue.

Les données des éléments dans les modèles se voient attribuer un ItemDataRole; chaque élément peut stocker un QVariant pour chaque rôle. QStyledItemDelegate met en œuvre l'affichage et l'édition des types de données les plus courants attendus par les utilisateurs, notamment les booléens, les entiers et les chaînes de caractères.

Les données seront affichées différemment en fonction du rôle qu'elles occupent dans le modèle. Le tableau suivant décrit les rôles et les types de données que le délégué peut gérer pour chacun d'entre eux. Il suffit souvent de s'assurer que le modèle renvoie les données appropriées pour chacun des rôles afin de déterminer l'apparence des éléments dans les vues.

Les éditeurs sont créés avec un QItemEditorFactory; une instance statique par défaut fournie par QItemEditorFactory est installée sur tous les délégués d'éléments. Vous pouvez définir une usine personnalisée en utilisant setItemEditorFactory() ou définir une nouvelle usine par défaut avec QItemEditorFactory::setDefaultFactory().

QItemEditorFactory *editorFactory = new QItemEditorFactory;
QItemEditorCreatorBase *creator = new QStandardItemEditorCreator<MyFancyDateTimeEdit>();
editorFactory->registerEditor(QMetaType::QDateTime, creator);

QItemEditorFactory::setDefaultFactory(editorFactory);

Une fois la nouvelle fabrique définie, tous les délégués d'éléments standard l'utiliseront (c'est-à-dire également les délégués qui ont été créés avant que la nouvelle fabrique par défaut n'ait été définie).

Ce sont les données stockées dans le modèle d'élément avec EditRole qui sont modifiées. Voir la classe QItemEditorFactory pour une introduction de plus haut niveau aux fabriques d'éditeurs d'éléments.

Sous-classement de QStyledItemDelegate

Si le délégué ne prend pas en charge la peinture des types de données dont vous avez besoin ou si vous souhaitez personnaliser le dessin des éléments, vous devez sous-classer QStyledItemDelegate et réimplémenter paint() et éventuellement sizeHint(). La fonction paint() est appelée individuellement pour chaque élément, et avec sizeHint(), vous pouvez spécifier l'indice pour chacun d'entre eux.

Lors de la réimplémentation de paint(), il convient généralement de gérer les types de données que l'on souhaite dessiner et d'utiliser l'implémentation de la superclasse pour les autres types.

La peinture des indicateurs de cases à cocher est réalisée par le style actuel. Le style spécifie également la taille et les rectangles de délimitation dans lesquels les données doivent être dessinées pour les différents rôles de données. Le rectangle de délimitation de l'élément lui-même est également calculé par le style. Lorsque l'on dessine des types de données déjà pris en charge, il est donc judicieux de demander au style d'indiquer ces rectangles de délimitation. La description de la classe QStyle décrit cela plus en détail.

Si vous souhaitez modifier l'un des rectangles de délimitation calculés par le style ou la peinture des indicateurs de cases à cocher, vous pouvez sous-classer QStyle. Notez toutefois que la taille des éléments peut également être modifiée en réimplémentant sizeHint().

Il est possible pour un délégué personnalisé de fournir des éditeurs sans utiliser de fabrique d'éléments d'éditeur. Dans ce cas, les fonctions virtuelles suivantes doivent être réimplémentées :

• createEditor() renvoie le widget utilisé pour modifier les données du modèle et peut être réimplémenté pour personnaliser le comportement d'édition.
• setEditorData() fournit au widget les données à manipuler.
• updateEditorGeometry() garantit que l'éditeur est affiché correctement par rapport à la vue de l'élément.
• setModelData() renvoie les données mises à jour au modèle.

L'exemple Star Delegate crée des éditeurs en réimplémentant ces méthodes.

QStyledItemDelegate vs. QItemDelegate

Depuis Qt 4.4, il existe deux classes de délégués : QItemDelegate et QStyledItemDelegate. Cependant, le délégué par défaut est QStyledItemDelegate. Ces deux classes sont des alternatives indépendantes pour peindre et fournir des éditeurs pour les éléments dans les vues. La différence entre elles est que QStyledItemDelegate utilise le style actuel pour peindre ses éléments. Nous recommandons donc d'utiliser QStyledItemDelegate comme classe de base lors de l'implémentation de délégués personnalisés ou lorsque l'on travaille avec des feuilles de style Qt. Le code requis pour l'une ou l'autre classe devrait être le même, à moins que le délégué personnalisé n'ait besoin d'utiliser le style pour dessiner.

Si vous souhaitez personnaliser la peinture des vues d'éléments, vous devez implémenter un style personnalisé. Veuillez consulter la documentation de la classe QStyle pour plus de détails.