QAbstractItemView Class

Documentation des fonctions membres

[explicit] QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

Crée une vue d'élément abstraite à partir de l'parent on fournie.

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

Ça gâche le paysage.

[signal] void QAbstractItemView::activated(const QModelIndex &index)

Ce signal est émis lorsque l'élément spécifié par index est activé par l'utilisateur. La manière d'activer les éléments dépend de la plate-forme ; par exemple, en cliquant une ou deux fois sur l'élément, ou en appuyant sur la touche Retour ou Entrée lorsque l'élément est sélectionné.

Voir également clicked(), doubleClicked(), entered() et pressed().

[slot] void QAbstractItemView::clearSelection()

Désélectionne tous les éléments sélectionnés. L'index actuel ne sera pas modifié.

Voir également setSelection() et selectAll().

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

Ce signal est émis lorsqu'on clique avec le bouton gauche de la souris. L'élément sur lequel la souris a été cliquée est spécifié par index. Le signal n'est émis que lorsque l'index est valide.

Voir également activated(), doubleClicked(), entered() et pressed().

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

Ferme l'editor donné et le libère. L'hint permet de spécifier comment la vue doit réagir à la fin de l'opération d'édition. Par exemple, l' peut indiquer que l'élément suivant de la vue doit être ouvert pour modification.

Voir également edit() et commitData().

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

Ferme l'éditeur persistant correspondant à l'élément situé à l'adresse index.

Voir également openPersistentEditor() et isPersistentEditorOpen().

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

Valider les données de la table « editor » dans le modèle.

Voir aussi closeEditor().

[virtual protected slot] void QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Cet emplacement est appelé lorsqu'un nouvel élément devient l'élément actif. L'élément actif précédent est spécifié par l'index « previous », et le nouvel élément par l'index « current ».

Si vous souhaitez en savoir plus sur les modifications apportées aux éléments, consultez le signal dataChanged().

QModelIndex QAbstractItemView::currentIndex() const

Renvoie l'index du modèle de l'élément actuel.

Voir aussi setCurrentIndex().

[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

Cet événement est déclenché lorsque des éléments dont l'roles est spécifiée sont modifiés dans le modèle. Les éléments modifiés sont ceux compris entre topLeft et bottomRight inclus. Si un seul élément est modifié, topLeft == bottomRight.

L’ roles, qui a été modifiée, peut être soit un conteneur vide (ce qui signifie que tout a changé), soit un conteneur non vide contenant le sous-ensemble des rôles qui ont été modifiés.

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

Renvoie l'offset des zones modifiées dans la vue.

Si vous utilisez ` scrollDirtyRegion()` et implémentez une méthode ` paintEvent()` dans une sous-classe de ` QAbstractItemView`, vous devez décaler la zone indiquée par l'événement de dessin en fonction du décalage renvoyé par cette fonction.

Voir également scrollDirtyRegion() et setDirtyRegion().

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

Ce signal est émis lorsqu'on effectue un double-clic avec la souris. L'élément sur lequel le double-clic a été effectué est spécifié par index. Le signal n'est émis que si l'index est valide.

Voir également clicked() et activated().

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

Réimplémente : QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

Cette fonction est appelée avec l'event fourni lorsqu'une opération de glisser-déposer entre dans le widget. Si le glissement se fait au-dessus d'un emplacement de dépôt valide (par exemple, au-dessus d'un élément acceptant les dépôts), l'événement est accepté ; sinon, il est ignoré.

Voir également dropEvent() et startDrag().

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

Réimplémentation de : ` QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)`.

Cette fonction est appelée lorsque l'élément en cours de glissement quitte la vue. Le paramètre event décrit l'état de l'opération de glisser-déposer.

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

Réimplémente : QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

Cette fonction est appelée en continu avec l'event fourni pendant une opération de glisser-déposer sur le widget. Elle peut entraîner le défilement de la vue si, par exemple, l'utilisateur fait glisser une sélection vers le bord droit ou inférieur de la vue. Dans ce cas, l'événement sera accepté ; sinon, il sera ignoré.

Voir également ` dropEvent()` et ` startDrag()`.

[override virtual protected] void QAbstractItemView::dropEvent(QDropEvent *event)

Réimplémente : QAbstractScrollArea::dropEvent(QDropEvent *event).

Cette fonction est appelée avec l'event fourni lorsqu'un événement de dépôt se produit sur le widget. Si le modèle accepte la position de l'événement, celui-ci est accepté ; sinon, il est ignoré.

Voir également startDrag().

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

Renvoie la position de l'indicateur de dépôt par rapport à l'élément le plus proche.

[slot] void QAbstractItemView::edit(const QModelIndex &index)

Lance la modification de l'élément correspondant à l'index e fournie, si celui-ci est modifiable.

Notez que cette fonction ne modifie pas l’index actuel. Étant donné que l’index actuel définit les éléments suivant et précédent à modifier, les utilisateurs peuvent constater que la navigation au clavier ne fonctionne pas comme prévu. Pour garantir un comportement de navigation cohérent, appelez la fonction setCurrentIndex() avant cette fonction, en lui passant le même index de modèle.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        abstractItemView, qOverload(&QAbstractItemView::edit));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        abstractItemView, [receiver = abstractItemView](const QModelIndex &index) { receiver->edit(index); });

Voir également QModelIndex::flags().

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

Lance la modification de l’élément à l’adresse index, en créant un éditeur si nécessaire, et renvoie true si l’ State de la vue est désormais EditingState; sinon, renvoie false.

L'action à l'origine du processus d'édition est décrite par trigger, et l'événement associé est spécifié par event.

L'édition peut être forcée en définissant trigger sur QAbstractItemView::AllEditTriggers.

Voir également closeEditor().

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

Cette fonction est appelée lorsque l'editor on indiquée a été détruite.

Voir aussi closeEditor().

[signal] void QAbstractItemView::entered(const QModelIndex &index)

Ce signal est émis lorsque le curseur de la souris entre dans l'élément spécifié par index. Le suivi de la souris doit être activé pour que cette fonctionnalité fonctionne.

Voir également viewportEntered(), activated(), clicked(), doubleClicked() et pressed().

[override virtual protected] bool QAbstractItemView::event(QEvent *event)

Réimplémente : QAbstractScrollArea::event(QEvent *event).

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

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

[protected] void QAbstractItemView::executeDelayedItemsLayout()

Exécute les mises en page planifiées sans attendre que le traitement des événements commence.

Voir également scheduleDelayedItemsLayout().

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

Réimplémente : QWidget::focusInEvent(QFocusEvent *event).

Cette fonction est appelée avec l'event donné lorsque le widget obtient le focus. Par défaut, l'événement est ignoré.

Voir également setFocus() et focusOutEvent().

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

Réimplémente : QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).

Cette fonction est appelée avec l'event fourni lorsque le widget perd le focus. Par défaut, l'événement est ignoré.

Voir également clearFocus() et focusInEvent().

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

Renvoie le décalage horizontal de la vue.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

Voir également ` verticalOffset()`.

[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const

Renvoie l'index du modèle de l'élément situé aux coordonnées de la fenêtre d'affichage point.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

Voir également visualRect().

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

Renvoie le widget correspondant à l'élément situé à l'adresse index.

Voir aussi setIndexWidget().

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

Initialiser la structure ` option ` avec la palette, la police, l'état, les alignements, etc. de la vue.

Cette fonction a été introduite dans Qt 6.0.

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

Réimplémente : QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

Réimplémente : ` QWidget::inputMethodQuery` (requête `Qt::InputMethodQuery`) const.

[pure virtual protected] bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const

Renvoie « true » si l'élément référencé par l'index donné est masqué dans la vue, sinon renvoie « false ».

Le masquage est une fonctionnalité propre à la vue. Par exemple, dans ` TableView `, une colonne peut être marquée comme masquée, ou une ligne dans ` TreeView`.

Dans la classe de base, il s’agit d’une fonction purement virtuelle.

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

Indique si un éditeur persistant est ouvert pour l'élément situé à l'index index.

Voir également openPersistentEditor() et closePersistentEditor().

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

Renvoie le délégué d'élément utilisé par cette vue et ce modèle. Il s'agit soit d'un délégué défini via la méthode ` setItemDelegate()`, soit du délégué par défaut.

Voir également setItemDelegate().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

Renvoie le délégué d'élément utilisé par cette vue et ce modèle pour l'column donné. Vous pouvez appeler la méthode itemDelegate() pour obtenir un pointeur vers le délégué actuel correspondant à un index donné.

Voir également setItemDelegateForColumn(), itemDelegateForRow() et itemDelegate().

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

Renvoie le délégué d'élément utilisé par cette vue et ce modèle pour l'index donné.

Cette fonction a été introduite dans Qt 6.0.

Voir également setItemDelegate(), setItemDelegateForRow() et setItemDelegateForColumn().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

Renvoie le délégué d'élément utilisé par cette vue et ce modèle pour l'row donné, ou nullptr si aucun délégué n'a été attribué. Vous pouvez appeler itemDelegate() pour obtenir un pointeur vers le délégué actuel correspondant à un index donné.

Voir également setItemDelegateForRow(), itemDelegateForColumn() et setItemDelegate().

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

Réimplémente : QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

Cette fonction est appelée avec l’ event donné lorsqu’un événement de touche est envoyé au widget. L’implémentation par défaut gère les mouvements de base du curseur, par exemple Haut, Bas, Gauche, Droite, Début, Page précédente et Page suivante ; le signal activated() est émis si l’index actuel est valide et que la touche d’activation est enfoncée (par exemple Entrée ou Retour, selon la plate-forme). C’est dans cette fonction que l’édition est lancée par une pression sur une touche, par exemple si l’on appuie sur F2.

Voir également edit(), moveCursor(), keyboardSearch() et tabKeyNavigation.

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

Se déplace vers l'élément correspondant le mieux à la chaîne « search » et le sélectionne. Si aucun élément n'est trouvé, rien ne se passe.

Dans l'implémentation par défaut, la recherche est réinitialisée si search est vide, ou si l'intervalle de temps écoulé depuis la dernière recherche a dépassé QApplication::keyboardInputInterval().

QAbstractItemModel *QAbstractItemView::model() const

Renvoie le modèle affiché par cette vue.

Voir aussi setModel().

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

Réimplémente : QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

Cette fonction est appelée avec l’ event donné lorsqu’un double-clic est effectué à l’intérieur du widget. Si le double-clic porte sur un élément valide, elle émet le signal doubleClicked() et appelle la fonction edit() sur cet élément.

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

Réimplémente : QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

Cette fonction est appelée avec l'event fournie lorsqu'un événement de déplacement de la souris est envoyé au widget. Si une sélection est en cours et que de nouveaux éléments sont déplacés dessus, la sélection est étendue ; si un glissement est en cours, il se poursuit.

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

Réimplémente : QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

Cette fonction est appelée avec l’ event donné lorsqu’un bouton de souris est enfoncé alors que le curseur se trouve à l’intérieur du widget. Si un élément valide est sélectionné, il devient l’élément actuel. Cette fonction émet le signal pressed().

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

Réimplémente : QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

Cette fonction est appelée avec l’objet ` event ` donné lorsqu’un bouton de souris est relâché, après un événement de clic sur le widget. Si un utilisateur clique à l’intérieur de votre widget puis fait glisser la souris vers un autre emplacement avant de relâcher le bouton, votre widget reçoit l’événement de relâchement. La fonction émettra le signal ` clicked()` si un élément était en cours de sélection.

[pure virtual protected] QModelIndex QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

Renvoie un objet ` QModelIndex ` pointant vers l'objet suivant dans la vue, en fonction de l'cursorAction fournie et des modificateurs de clavier spécifiés par ` modifiers`.

Dans la classe de base, il s'agit d'une fonction virtuelle pure.

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

Ouvre un éditeur persistant sur l'élément situé à l'index indiquée. Si aucun éditeur n'existe, le délégué en créera un nouveau.

Voir également closePersistentEditor() et isPersistentEditorOpen().

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

Ce signal est émis lorsqu'un bouton de la souris est enfoncé. L'élément sur lequel la souris a été enfoncée est spécifié par ` index`. Le signal n'est émis que lorsque l'index est valide.

Utilisez la fonction QGuiApplication::mouseButtons() pour obtenir l'état des boutons de la souris.

Voir également activated(), clicked(), doubleClicked() et entered().

[virtual slot] void QAbstractItemView::reset()

Réinitialise l'état interne de la vue.

[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)

Réimplémente : QAbstractScrollArea::resizeEvent(QResizeEvent *event).

Cette fonction est appelée avec l'event donné lorsqu'un événement de redimensionnement est envoyé au widget.

Voir également QWidget::resizeEvent().

QModelIndex QAbstractItemView::rootIndex() const

Renvoie l'index du modèle correspondant à l'élément racine de ce dernier. L'élément racine est l'élément parent des éléments de niveau supérieur de la vue. La racine peut être invalide.

Voir également setRootIndex().

[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

Cette méthode est appelée lorsque des lignes sont sur le point d'être supprimées. Les lignes supprimées sont celles situées sous l'parent donné, allant de « start » à « end » inclus.

Voir aussi rowsInserted().

[virtual protected slot] void QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)

Cette méthode est appelée lors de l'insertion de lignes. Les nouvelles lignes correspondent à celles situées sous l'parent spécifiée, comprise entre start et end inclus. L'implémentation de la classe parente appelle la méthode `fetchMore()` du modèle pour vérifier s'il existe d'autres données.

Voir également rowsAboutToBeRemoved().

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

Planifie la mise en page des éléments de la vue à exécuter lorsque le traitement des événements démarre.

Même si la fonction scheduleDelayedItemsLayout() est appelée plusieurs fois avant le traitement des événements, la vue n'effectuera la mise en page qu'une seule fois.

Voir également ` executeDelayedItemsLayout()`.

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

Prépare la vue pour un défilement de (dx,dy) pixels en déplaçant les zones modifiées dans la direction opposée. Vous ne devez appeler cette fonction que si vous implémentez une zone de défilement dans votre sous-classe de vue.

Si vous implémentez ` scrollContentsBy()` dans une sous-classe de ` QAbstractItemView`, appelez cette fonction avant d’appeler ` QWidget::scroll()` sur la fenêtre de visualisation. Vous pouvez également vous contenter d’appeler ` update()`.

Voir également scrollContentsBy(), dirtyRegionOffset() et setDirtyRegion().

[pure virtual] void QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

Fait défiler la vue si nécessaire pour s'assurer que l'élément situé à l'adresse index soit visible. La vue tentera de positionner l'élément conformément à l'hint fournie.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

[slot] void QAbstractItemView::scrollToBottom()

Fait défiler la vue jusqu'en bas.

Voir également scrollTo() et scrollToTop().

[slot] void QAbstractItemView::scrollToTop()

Fait défiler la vue vers le haut.

Voir également scrollTo() et scrollToBottom().

[virtual slot] void QAbstractItemView::selectAll()

Sélectionne tous les éléments de la vue. Lors de la sélection, cette fonction utilise le comportement de sélection défini pour la vue.

Voir également setSelection(), selectedIndexes() et clearSelection().

[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const

Cette fonction pratique renvoie une liste de tous les index des éléments sélectionnés et non masqués dans la vue. La liste ne contient aucun doublon et n'est pas triée.

Voir également QItemSelectionModel::selectedIndexes().

[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Cette méthode est appelée lorsque la sélection est modifiée. La sélection précédente (qui peut être vide) est spécifiée par ` deselected`, et la nouvelle sélection par ` selected`.

Voir également setSelection().

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

Renvoie les SelectionFlags à utiliser lors de la mise à jour d'un modèle de sélection pour l'index spécifié. Le résultat dépend de l'selectionMode() en cours et de l'événement de saisie utilisateur event, qui peut être nullptr.

Réimplémentez cette fonction pour définir votre propre comportement de sélection.

Voir également setSelection().

QItemSelectionModel *QAbstractItemView::selectionModel() const

Renvoie le modèle de sélection actuel.

Voir également setSelectionModel() et selectedIndexes().

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

Définit l'élément actuel comme étant celui situé à l'adresse index.

À moins que le mode de sélection actuel ne soit « NoSelection », l’élément est également sélectionné. Notez que cette fonction met également à jour la position de départ pour toute nouvelle sélection effectuée par l’utilisateur.

Pour définir un élément comme élément courant sans le sélectionner, appelez

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

Voir également currentIndex(), currentChanged() et selectionMode.

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

Marque l'region on donnée comme « sale » et planifie sa mise à jour. Vous ne devez appeler cette fonction que si vous implémentez votre propre sous-classe de vue.

Voir également ` scrollDirtyRegion()` et ` dirtyRegionOffset()`.

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

Définit l'widget spécifiée sur l'élément situé à l'index indiquée, en transférant la propriété du widget à la fenêtre d'affichage.

Si l'index n'est pas valide (par exemple, si vous transmettez l'index racine), cette fonction n'effectuera aucune action.

La propriété autoFillBackground de l'widget spécifié doit être définie sur true, sinon l'arrière-plan du widget sera transparent, affichant à la fois les données du modèle et l'élément à l'adresse index spécifiée.

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

Cette fonction ne doit être utilisée que pour afficher du contenu statique dans la zone visible correspondant à un élément de données. Si vous souhaitez afficher du contenu dynamique personnalisé ou implémenter un widget d’éditeur personnalisé, créez plutôt une sous-classe de QStyledItemDelegate.

Voir également indexWidget() et Classes de délégués.

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

Définit le délégué d'élément pour cette vue et son modèle sur delegate. Cela s'avère utile si vous souhaitez contrôler entièrement la modification et l'affichage des éléments.

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

Voir également itemDelegate().

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

Définit l'delegate de l'élément spécifié, utilisé par cette vue et ce modèle pour l'column donné. Tous les éléments de column seront dessinés et gérés par delegate au lieu d'utiliser le délégué par défaut (c'est-à-dire itemDelegate()).

Tout délégué de colonne existant pour column sera supprimé, mais pas effacé. QAbstractItemView ne prend pas possession de delegate.

Voir également itemDelegateForColumn(), setItemDelegateForRow() et itemDelegate().

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

Définit l'élément delegate spécifié comme délégué utilisé par cette vue et ce modèle pour l'row donné. Tous les éléments de row seront dessinés et gérés par delegate au lieu d'utiliser le délégué par défaut (à savoir, itemDelegate()).

Tout délégué de ligne existant pour row sera supprimé, mais pas effacé. QAbstractItemView ne prend pas possession de delegate.

Voir également ` itemDelegateForRow()`, ` setItemDelegateForColumn()` et ` itemDelegate()`.

[virtual] void QAbstractItemView::setModel(QAbstractItemModel *model)

Définit le modèle de sélection ( model ) que la vue doit afficher.

Cette fonction crée et définit un nouveau modèle de sélection, remplaçant tout modèle précédemment défini à l’aide de la fonction ` setSelectionModel()`. Toutefois, l’ancien modèle de sélection n’est pas supprimé, car il peut être partagé entre plusieurs vues. Nous vous recommandons de supprimer l’ancien modèle de sélection s’il n’est plus nécessaire. Pour ce faire, utilisez le code suivant :

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

Si l’ancien modèle et l’ancien modèle de sélection n’ont pas de parents, ou si leurs parents sont des objets à longue durée de vie, il peut être préférable d’appeler leurs fonctions ` deleteLater()` pour les supprimer explicitement.

La vue ne prend pas possession du modèle à moins d’être l’objet parent de celui-ci, car le modèle peut être partagé entre de nombreuses vues différentes.

Voir également model(), selectionModel() et setSelectionModel().

[virtual slot] void QAbstractItemView::setRootIndex(const QModelIndex &index)

Définit l'élément racine sur l'élément situé à l'adresse index.

Voir aussi rootIndex().

[pure virtual protected] void QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Applique la sélection flags aux éléments situés à l'intérieur du rectangle ou touchés par celui-ci, rect.

Lorsque vous implémentez votre propre `itemview`, la méthode `setSelection` doit appeler ` selectionModel()`->`select(selection, flags)`, où `selection` est soit une collection vide de type ` QModelIndex `, soit une collection de type ` QItemSelection ` contenant tous les éléments présents dans ` rect`.

Voir également selectionCommand() et selectedIndexes().

[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)

Définit le modèle de sélection actuel sur l'selectionModel spécifié.

Notez que si vous appelez ` setModel()` après cette fonction, l’ selectionModel on indiquée sera remplacée par celle créée par la vue.

Voir également selectionModel(), setModel() et clearSelection().

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

Définit l'état de la vue de l'élément sur la valeur indiquée state.

Voir également state().

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

Renvoie l'indication de largeur pour l'column spécifiée, ou -1 s'il n'y a pas de modèle.

Cette fonction est utilisée dans les vues comportant un en-tête horizontal pour déterminer la taille recommandée d’une section d’en-tête en fonction du contenu de l’ column donné.

Voir également sizeHintForRow().

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

Renvoie l'indication de taille pour l'élément dont l'index est spécifiée, ou une taille non valide si les index ne sont pas valides.

Voir également sizeHintForRow() et sizeHintForColumn().

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

Renvoie la valeur indicative de hauteur pour l'row spécifié, ou -1 s'il n'y a pas de modèle.

La hauteur renvoyée est calculée à partir des indications de taille des éléments de l’ row donné ; en d’autres termes, la valeur renvoyée correspond à la hauteur maximale parmi ces éléments. Notez que pour contrôler la hauteur d’une ligne, vous devez réimplémenter la fonction QAbstractItemDelegate::sizeHint().

Cette fonction est utilisée dans les vues comportant un en-tête vertical pour déterminer la taille indicative d’une section d’en-tête en fonction du contenu de l’ row donné.

Voir également sizeHintForColumn().

[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)

Lance un glissement en appelant la méthode drag->exec() avec l'supportedActions on fournie.

[protected] QAbstractItemView::State QAbstractItemView::state() const

Renvoie l'état de la vue de l'élément.

Voir aussi setState().

[override virtual protected] void QAbstractItemView::timerEvent(QTimerEvent *event)

Réimplémente : QObject::timerEvent(QTimerEvent *event).

Cette fonction est appelée avec l'event fourni lorsqu'un événement de minuterie est envoyé au widget.

Voir aussi QObject::timerEvent().

[slot] void QAbstractItemView::update(const QModelIndex &index)

Met à jour la zone occupée par l'index donnée.

[virtual protected slot] void QAbstractItemView::updateGeometries()

Met à jour la géométrie des widgets enfants de la vue.

[pure virtual protected] int QAbstractItemView::verticalOffset() const

Renvoie le décalage vertical de la vue.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

Voir également ` horizontalOffset()`.

[signal] void QAbstractItemView::viewportEntered()

Ce signal est émis lorsque le curseur de la souris entre dans la zone d'affichage. Le suivi de la souris doit être activé pour que cette fonctionnalité fonctionne.

Voir également entered().

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

Réimplémente : QAbstractScrollArea::viewportEvent(QEvent *event).

Cette fonction sert à gérer les info-bulles et le mode « Qu'est-ce que c'est ? », si l'objet ` event ` fourni est un ` QEvent::ToolTip` ou un ` QEvent::WhatsThis`. Elle transmet tous les autres événements au gestionnaire `viewportEvent()` de sa classe de base.

Renvoie ` true ` si ` event ` a été reconnu et traité ; sinon, renvoie ` false`.

[override virtual protected] QSize QAbstractItemView::viewportSizeHint() const

Réimplémente : QAbstractScrollArea::viewportSizeHint() const.

[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const

Renvoie le rectangle occupé par l'élément dans la fenêtre d'affichage à l'adresse index.

Si votre élément s'affiche dans plusieurs zones, visualRect doit renvoyer la zone principale qui contient l'index, et non la zone complète que l'index pourrait englober, toucher ou faire dessiner.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

Voir également ` indexAt()` et ` visualRegionForSelection()`.

[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

Renvoie la région correspondant à la fenêtre d'affichage des éléments de l'selection donné.

Dans la classe de base, il s'agit d'une fonction purement virtuelle.

Voir également ` visualRect()` et ` selectedIndexes()`.