QItemDelegate Class

Documentation des fonctions membres

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

Construit un délégué de l'élément avec l'adresse parent.

[virtual noexcept] QItemDelegate::~QItemDelegate()

Détruit 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 sont utilisés pour contrôler l'apparence du widget de l'éditeur.

Voir aussi QAbstractItemDelegate::createEditor().

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

Rend l'arrière-plan de l'élément pour la valeur donnée index, en utilisant la valeur donnée painter et le style option.

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

Crée un indicateur de contrôle dans le rectangle spécifié par rect, en utilisant les données painter et le style option, en utilisant les données state.

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

Rend la décoration pixmap à l'intérieur du rectangle spécifié par rect en utilisant le style painter et le style option.

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

Rend la vue de l'élément text à l'intérieur du rectangle spécifié par rect en utilisant le style painter et le style option.

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

Rend la région à l'intérieur du rectangle spécifié par rect, en indiquant qu'elle est au centre de l'attention, à l'aide de painter et du style option.

[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 aussi 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.

Effectue le rendu du délégué à l'aide de painter et du style option 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 détenue par la variable rect de l'option, en utilisant la variable state de l'option pour déterminer l'état de l'élément à afficher, et ajuster la façon dont il est peint en conséquence.

Par exemple, un élément sélectionné peut ê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 avoir peint, vous devez vous assurer que le peintre est ramené à l'état dans lequel il a été fourni lorsque cette fonction a été appelée. Par exemple, il peut être utile d'appeler QPainter::save() avant de peindre 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 de modèle de données spécifié par le modèle index.

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

Voir aussi QMetaProperty::isUser().

void QItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

Définit l'usine d'édition à utiliser par le délégué de l'élément à l'adresse factory spécifiée. Si aucune usine d'édition n'est définie, le délégué de l'élément utilisera l'usine d'édition 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 le widget model spécifié à l'élément index.

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

Voir aussi 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, il convient de noter que dans le cas d'éléments textuels, 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 le site editor pour l'élément spécifié par index en fonction du style option indiqué.