QItemDelegate Class

Documentation des fonctions membres

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

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

[virtual noexcept] QItemDelegate::~QItemDelegate()

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

[override virtual] QWidget *QItemDelegate::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 parent et le style option permettent de contrôler l’apparence du widget d’édition.

Voir aussi QAbstractItemDelegate::createEditor().

[protected] void QItemDelegate::drawBackground(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Affiche l'arrière-plan de l'élément pour l'index donné, en utilisant l'painter et le style option fournis.

[virtual protected] void QItemDelegate::drawCheck(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, Qt::CheckState state) const

Affiche un indicateur de coche à l'intérieur du rectangle défini par ` rect`, en utilisant l'painter et le style ` option` indiqués, ainsi que la couleur ` state` spécifiée.

[virtual protected] void QItemDelegate::drawDecoration(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, const QPixmap &pixmap) const

Affiche la décoration pixmap à l'intérieur du rectangle défini par rect en utilisant l'painter et le style option indiqués.

[virtual protected] void QItemDelegate::drawDisplay(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, const QString &text) const

Affiche la vue de l'élément text dans le rectangle spécifié par rect en utilisant l'painter et le style option fournis.

[virtual protected] void QItemDelegate::drawFocus(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect) const

Affiche la zone située à l'intérieur du rectangle spécifié par rect, en indiquant qu'elle a le focus, en utilisant l'painter et le style option fournis.

[override virtual protected] bool QItemDelegate::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 QItemDelegate::eventFilter(QObject *object, QEvent *event)

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

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

QItemEditorFactory *QItemDelegate::itemEditorFactory() const

Renvoie la fabrique d'éditeurs utilisée par le délégué de l'élément. Si aucune fabrique d'éditeurs n'est définie, la fonction renvoie null.

Voir également setItemEditorFactory().

[override virtual] void QItemDelegate::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.

Lorsque vous réimplémentez cette fonction dans une sous-classe, vous devez mettre à jour la zone contenue dans la variable ` rect ` de l’option, en utilisant la variable ` state ` de l’option pour déterminer l’état de l’élément à afficher, puis ajuster son rendu en conséquence.

Par exemple, un élément sélectionné peut devoir être affiché différemment des éléments non sélectionnés, comme le montre le code suivant :

if (option.state & QStyle::State_Selected)
    painter->fillRect(option.rect, option.palette.highlight());

Après le dessin, vous devez vous assurer que le « painter » est ramené à 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 ` QStyle::State`.

[override virtual] void QItemDelegate::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 le widget ` 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 QItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

Définit l'éditeur de base que le délégué d'élément doit utiliser comme étant celui spécifié par factory. Si aucun éditeur de base n'est défini, le délégué d'élément utilisera l'éditeur de base par défaut.

Voir également itemEditorFactory().

[override virtual] void QItemDelegate::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'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 QItemDelegate::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`.

Lors de la réimplémentation de cette fonction, notez que dans le cas d’éléments de texte, QItemDelegate ajoute une marge (c’est-à-dire 2 * QStyle::PM_FocusFrameHMargin) à la longueur du texte.

[override virtual] void QItemDelegate::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'editor pour l'élément spécifié par index conformément à l'option de style fournie.