QStyledItemDelegate Class

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

QItemEditorFactory::setDefaultFactory(editorFactory);

Documentation sur les fonctions membres

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

Crée un délégué d'élément à partir de l'parent on fournie.

[virtual noexcept] QStyledItemDelegate::~QStyledItemDelegate()

Supprime le délégué de l'élément.

[override virtual] QWidget *QStyledItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

Réimplémente : ` QAbstractItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const`.

Renvoie le widget utilisé pour modifier l’élément spécifié par index. Le widget d’ parent et le style option permettent de contrôler l’apparence du widget d’édition.

Voir aussi QAbstractItemDelegate::createEditor().

[virtual] QString QStyledItemDelegate::displayText(const QVariant &value, const QLocale &locale) const

Cette fonction renvoie la chaîne que le délégué utilisera pour afficher l'Qt::DisplayRole du modèle dans locale. value correspond à la valeur de l'Qt::DisplayRole fournie par le modèle.

L'implémentation par défaut utilise l'QLocale::toString pour convertir value en QString.

Cette fonction n’est pas appelée pour les indices de modèle vides, c’est-à-dire les indices pour lesquels le modèle renvoie une valeur QVariant non valide.

Voir également QAbstractItemModel::data().

[override virtual protected] bool QStyledItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)

Réimplémente : QAbstractItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index).

[override virtual protected] bool QStyledItemDelegate::eventFilter(QObject *object, QEvent *event)

Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).

Voir les détails dans QAbstractItemDelegate::handleEditorEvent().

[virtual protected] void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, const QModelIndex &index) const

Initialisez ` option ` avec les valeurs fournies par l'index ` index`. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionViewItem`, mais ne souhaitent pas remplir elles-mêmes toutes les informations.

Voir également QStyleOption::initFrom().

QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const

Renvoie l'éditeur de fabrique utilisé par le délégué d'élément. Si aucun éditeur de fabrique n'est défini, la fonction renvoie null.

Voir également setItemEditorFactory().

[override virtual] void QStyledItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Réimplémente : QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const.

Affiche le délégué en utilisant l’ painter et l’ option de style fournis pour l’élément spécifié par index.

Cette fonction dessine l'élément en utilisant l'QStyle de la vue.

Lors de la réimplémentation de paint dans une sous-classe, utilisez la méthode initStyleOption() pour configurer l’ option de la même manière que QStyledItemDelegate.

Dans la mesure du possible, utilisez la méthode ` option ` pendant le dessin. Utilisez notamment sa variable ` rect ` pour déterminer où dessiner et sa variable ` state ` pour déterminer si l’élément est activé ou sélectionné.

Après le dessin, vous devez vous assurer que le « painter » est remis dans l’état dans lequel il se trouvait lors de l’appel de cette fonction. Par exemple, il peut être utile d’appeler ` QPainter::save()` avant le dessin et ` QPainter::restore()` après.

Voir également QItemDelegate::paint(), QStyle::drawControl() et QStyle::CE_ItemViewItem.

[override virtual] void QStyledItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const

Réimplémente : QAbstractItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const.

Définit les données à afficher et à modifier par l'editor à partir de l'élément du modèle de données spécifié par l'index.

L'implémentation par défaut stocke les données dans la propriété « user » du widget « editor ».

Voir aussi ` QMetaProperty::isUser()` .

void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

Définit la fabrique d'éditeurs que le délégué d'élément doit utiliser comme étant celle spécifiée à l'adresse factory. Si aucune fabrique d'éditeurs n'est définie, le délégué d'élément utilisera la fabrique d'éditeurs par défaut.

Voir également itemEditorFactory().

[override virtual] void QStyledItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

Réimplémente : QAbstractItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const.

Récupère les données du widget « editor » et les stocke dans l'model spécifié, à l'emplacement index.

L'implémentation par défaut récupère la valeur à stocker dans le modèle de données à partir de la propriété utilisateur du widget « editor ».

Voir également QMetaProperty::isUser().

[override virtual] QSize QStyledItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

Réimplémente : QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const.

Renvoie la taille nécessaire au délégué pour afficher l’élément spécifié par ` index`, en tenant compte des informations de style fournies par ` option`.

Cette fonction utilise la propriété ` QStyle ` de la vue pour déterminer la taille de l'élément.

Voir également QStyle::sizeFromContents() et QStyle::CT_ItemViewItem.

[override virtual] void QStyledItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const

Réimplémente : QAbstractItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const.

Met à jour l'objet ` editor ` correspondant à l'élément spécifié par ` index `, conformément à l'option de style fournie.