QAbstractItemView Class

Documentation des fonctions membres

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

Construit une vue abstraite de l'élément avec l'adresse parent.

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

Détruit la vue.

[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 plateforme ; par exemple, en cliquant une fois ou deux fois sur l'élément, ou en appuyant sur la touche Retour ou Entrée lorsque l'élément est en cours.

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'un bouton de la souris est cliqué avec le bouton gauche. L'élément sur lequel la souris a cliqué est spécifié par index. Le signal n'est émis que si l'index est valide.

Voir aussi activated(), doubleClicked(), entered() et pressed().

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

Ferme le site editor et le libère. L'adresse hint est utilisée pour indiquer comment la vue doit réagir à la fin de l'opération d'édition. Par exemple, l'indice peut indiquer que l'élément suivant de la vue doit être ouvert à l'édition.

Voir également edit() et commitData().

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

Ferme l'éditeur persistant pour l'élément à l'adresse index.

Voir également openPersistentEditor() et isPersistentEditorOpen().

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

Enregistrer les données contenues dans le site editor dans le modèle.

Voir également closeEditor().

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

Ce slot est appelé lorsqu'un nouvel élément devient l'élément courant. L'élément courant précédent est spécifié par l'indice previous, et le nouvel élément par l'indice current.

Pour connaître 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 en cours.

Voir aussi setCurrentIndex().

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

Ce slot est appelé lorsque des éléments portant le numéro roles 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.

Les roles qui ont été modifiés peuvent être soit un conteneur vide (signifiant que tout a changé), soit un conteneur non vide avec le sous-ensemble des rôles qui ont changé.

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

Renvoie le décalage des régions sales dans la vue.

Si vous utilisez scrollDirtyRegion() et implémentez paintEvent() dans une sous-classe de QAbstractItemView, vous devez traduire la zone donnée par l'événement paint avec le décalage renvoyé par cette fonction.

Voir également scrollDirtyRegion() et setDirtyRegion().

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

Ce signal est émis lorsqu'un bouton de la souris est doublement cliqué. L'élément sur lequel la souris a double-cliqué est spécifié par index. Le signal n'est émis que si l'index est valide.

Voir aussi 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'adresse event lorsqu'une opération de glisser-déposer entre dans le widget. Si le glissement s'effectue au-dessus d'un point de chute valide (par exemple, au-dessus d'un élément qui accepte les chutes), l'événement est accepté ; sinon, il est ignoré.

Voir également dropEvent() et startDrag().

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

Réimplémente : QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

Cette fonction est appelée lorsque l'élément glissé quitte la vue. Le site 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 la valeur event lors d'une opération de glisser-déposer sur le widget. Elle peut provoquer le défilement de la vue si, par exemple, l'utilisateur fait glisser une sélection jusqu'au 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'adresse event lorsqu'un événement de chute se produit sur le widget. Si le modèle accepte la position paire, l'événement de chute est accepté ; sinon, il est ignoré.

Voir également startDrag().

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

Renvoie la position de l'indicateur de chute par rapport à l'élément le plus proche.

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

Lance l'édition de l'élément correspondant à l'adresse index donnée, s'il est éditable.

Notez que cette fonction ne modifie pas l'index courant. Étant donné que l'index actuel définit les éléments suivants et précédents à éditer, les utilisateurs peuvent constater que la navigation au clavier ne fonctionne pas comme prévu. Pour assurer une navigation cohérente, appelez setCurrentIndex() avant cette fonction avec 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 aussi QModelIndex::flags().

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

Commence à éditer l'élément à index, en créant un éditeur si nécessaire, et renvoie true si la vue State est maintenant 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 spécifiant que trigger doit être QAbstractItemView::AllEditTriggers.

Voir aussi closeEditor().

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

Cette fonction est appelée lorsque le site editor a été détruit.

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 aussi 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 programmées sans attendre le début du traitement de l'événement.

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'adresse event 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'adresse event 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 virtuelle pure.

Voir également verticalOffset().

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

Renvoie l'indice de modèle de l'élément aux coordonnées du point de vue point.

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

Voir également visualRect().

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

Renvoie le widget de l'élément à 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(Qt::InputMethodQuery query) const.

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

Renvoie true si l'élément auquel se réfère l'adresse index est caché dans la vue, sinon renvoie false.

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

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

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

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

Voir également openPersistentEditor() et closePersistentEditor().

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

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

Voir aussi setItemDelegate().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

Renvoie le délégué de l'élément utilisé par cette vue et ce modèle pour l'adresse column donnée. Vous pouvez appeler itemDelegate() pour obtenir un pointeur sur le délégué actuel pour un index donné.

Voir aussi 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'adresse index.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setItemDelegate(), setItemDelegateForRow(), et setItemDelegateForColumn().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

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

Voir aussi 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'adresse event lorsqu'un événement touche est envoyé au widget. L'implémentation par défaut gère les mouvements de base du curseur, par exemple Up, Down, Left, Right, Home, PageUp et PageDown ; le signal activated() est émis si l'index actuel est valide et si la touche d'activation est pressée (par exemple Enter ou Return, en fonction de la plateforme). Cette fonction est utilisée lorsque l'édition est initiée par la pression d'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 et sélectionne l'élément qui correspond le mieux à la chaîne de caractères search. 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 depuis la dernière recherche a dépassé QApplication::keyboardInputInterval().

QAbstractItemModel *QAbstractItemView::model() const

Renvoie le modèle que cette vue présente.

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'adresse event lorsqu'un bouton de la souris est doublement cliqué à l'intérieur du widget. Si le double-clic est sur un élément valide, elle émet le signal doubleClicked() et appelle edit() sur l'élément.

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

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

Cette fonction est appelée avec l'adresse event 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, la sélection est étendue ; si un déplacement est en cours, elle est poursuivie.

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

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

Cette fonction est appelée avec l'adresse event lorsqu'un bouton de la souris est pressé alors que le curseur se trouve à l'intérieur du widget. Si un élément valide est pressé, il devient l'élément courant. 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'adresse event lorsqu'un bouton de la souris est relâché, après un événement de pression de la souris sur le widget. Si un utilisateur appuie sur la souris à l'intérieur de votre widget, puis déplace la souris vers un autre endroit avant de relâcher le bouton de la souris, votre widget reçoit l'événement de relâchement. La fonction émettra le signal clicked() si un élément a été pressé.

[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 cursorAction 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 à l'adresse index. 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é pressée est spécifié par index. Le signal n'est émis que si l'index est valide.

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

Voir aussi 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'adresse event lorsqu'un événement de redimensionnement est envoyé au widget.

Voir également QWidget::resizeEvent().

QModelIndex QAbstractItemView::rootIndex() const

Renvoie l'index du modèle de l'élément racine du modèle. 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 aussi setRootIndex().

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

Ce slot est appelé lorsque des lignes sont sur le point d'être supprimées. Les lignes supprimées sont celles qui se trouvent sous parent, de start à end inclus.

Voir aussi rowsInserted().

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

Ce slot est appelé lorsque des lignes sont insérées. Les nouvelles lignes sont celles qui se trouvent sous la rubrique parent, de start à end inclus. L'implémentation de la classe de base appelle fetchMore() sur le modèle pour vérifier s'il y a plus de données.

Voir aussi rowsAboutToBeRemoved().

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

Planifie une mise en page des éléments de la vue à exécuter lorsque le traitement de l'événement commence.

Même si scheduleDelayedItemsLayout() est appelé plusieurs fois avant que les événements ne soient traités, 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 à un défilement de (dx,dy) pixels en déplaçant les régions sales dans la direction opposée. Vous ne devez appeler cette fonction que si vous implémentez une fenêtre 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. Sinon, appelez simplement update().

Voir aussi 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é à index est visible. La vue essaiera de positionner l'élément en fonction de l'adresse hint.

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

[slot] void QAbstractItemView::scrollToBottom()

Fait défiler la vue jusqu'en bas.

Voir aussi scrollTo() et scrollToTop().

[slot] void QAbstractItemView::scrollToTop()

Fait défiler la vue jusqu'en haut.

Voir aussi scrollTo() et scrollToBottom().

[virtual slot] void QAbstractItemView::selectAll()

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

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

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

Cette fonction de commodité renvoie une liste de tous les index d'éléments sélectionnés et non cachés de la vue. La liste ne contient pas de doublons et n'est pas triée.

Voir également QItemSelectionModel::selectedIndexes().

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

Ce slot est appelé 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 aussi 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'objet spécifié index. Le résultat dépend de l'état actuel selectionMode() et de l'événement de saisie de l'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 aussi setSelectionModel() et selectedIndexes().

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

Définit l'élément en cours comme étant l'élément à index.

Si le mode de sélection actuel n'est pas 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 faire d'un élément l'é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 le site region donné 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 aussi scrollDirtyRegion() et dirtyRegionOffset().

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

Définit l'élément widget sur l'élément index, en transmettant la propriété du widget à la fenêtre de visualisation.

Si index n'est pas valide (par exemple, si vous transmettez l'index de la racine), cette fonction ne fera rien.

La propriété autoFillBackground de widget doit avoir la valeur true, sinon l'arrière-plan du widget sera transparent, montrant à la fois les données du modèle et l'élément à l'adresse index.

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

Cette fonction ne doit être utilisée que pour afficher un contenu statique dans la zone visible correspondant à un élément de données. Si vous souhaitez afficher un contenu dynamique personnalisé ou mettre en œuvre un widget d'édition personnalisé, sous-classez plutôt QStyledItemDelegate.

Voir aussi indexWidget() et Delegate Classes.

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

Définit le délégué de l'élément pour cette vue et son modèle à delegate. Ceci est utile si vous voulez un contrôle complet sur l'édition et l'affichage des éléments.

Tout délégué existant sera supprimé, mais pas effacé. QAbstractItemView n'est pas propriétaire de delegate.

Voir également itemDelegate().

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

Définit l'élément delegate utilisé par cette vue et ce modèle pour l'élément column. Tous les éléments sur 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 n'est pas propriétaire de delegate.

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

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

Définit l'élément delegate utilisé par cette vue et ce modèle pour l'élément row. Tous les éléments sur row 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 ligne existant pour row sera supprimé, mais pas effacé. QAbstractItemView n'est pas propriétaire de delegate.

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

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

Définit le site model pour la vue à présenter.

Cette fonction crée et définit un nouveau modèle de sélection, remplaçant tout modèle précédemment défini avec setSelectionModel(). Cependant, l'ancien modèle de sélection ne sera pas supprimé car il peut être partagé par 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 devient propriétaire du modèle que si elle est l'objet parent du modèle, car le modèle peut être partagé entre plusieurs vues différentes.

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

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

Définit l'élément racine comme étant 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 dans le rectangle ou touchés par celui-ci, rect.

Lors de l'implémentation de votre propre vue d'élément, setSelection doit appeler selectionModel()->select(selection, flags) où selection est soit un QModelIndex vide, soit un QItemSelection qui contient tous les éléments contenus dans rect.

Voir également selectionCommand() et selectedIndexes().

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

Définit le modèle de sélection actuel à l'adresse selectionModel.

Notez que si vous appelez setModel() après cette fonction, le modèle selectionModel sera remplacé par un modèle créé par la vue.

Voir aussi selectionModel(), setModel() et clearSelection().

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

Définit l'état de la vue de l'élément à l'adresse state.

Voir aussi state().

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

Renvoie l'indice de taille de la largeur pour le modèle spécifié column ou -1 s'il n'y a pas de modèle.

Cette fonction est utilisée dans les vues avec un en-tête horizontal pour trouver l'indice de taille d'une section d'en-tête en fonction du contenu de l'adresse column.

Voir également sizeHintForRow().

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

Renvoie l'indice de taille pour l'élément avec l'adresse index spécifiée ou une taille non valide pour les index non valides.

Voir aussi sizeHintForRow() et sizeHintForColumn().

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

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

La hauteur renvoyée est calculée à l'aide des indices de taille des éléments de row, c'est-à-dire que la valeur renvoyée est la hauteur maximale parmi les é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 avec un en-tête vertical pour trouver l'indice de taille d'une section d'en-tête en fonction du contenu de l'élément row.

Voir également sizeHintForColumn().

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

Démarre un drag en appelant drag->exec() à l'aide de l'adresse supportedActions.

[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'adresse event lorsqu'un événement de temporisation est envoyé au widget.

Voir également QObject::timerEvent().

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

Met à jour la zone occupée par le site index.

[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 virtuelle pure.

Voir également horizontalOffset().

[signal] void QAbstractItemView::viewportEntered()

Ce signal est émis lorsque le curseur de la souris entre dans la fenêtre de visualisation. 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 est utilisée pour gérer les infobulles et le mode What's This ? si le site event est un site QEvent::ToolTip ou QEvent::WhatsThis. Elle transmet tous les autres événements au gestionnaire viewportEvent() de sa classe de base.

Retourne true si event a été reconnu et traité ; sinon, retourne 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 de la fenêtre de visualisation occupé par l'élément à l'adresse index.

Si votre élément est affiché 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 dessiner.

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

Voir également indexAt() et visualRegionForSelection().

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

Renvoie la région de la fenêtre de visualisation des éléments de la page selection.

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

Voir aussi visualRect() et selectedIndexes().