ItemSelectionModel QML Type
Instancie un QItemSelectionModel à utiliser en conjonction avec un QAbstractItemModel et toute vue le prenant en charge. Plus d'informations...
| Import Statement: | import QtQml.Models |
| In C++: | QItemSelectionModel |
Propriétés
- currentIndex : QModelIndex
- hasSelection : bool
- model : QAbstractItemModel
- selectedIndexes : list<var>
- selection : object
Signaux
- currentChanged(QModelIndex current, QModelIndex previous)
- selectionChanged(QItemSelection selected, QItemSelection deselected)
Méthodes
- void clear()
- void clearCurrentIndex()
- void clearSelection()
- bool columnIntersectsSelection(int column, QModelIndex parent)
- bool isColumnSelected(int column, QModelIndex parent)
- bool isRowSelected(int row, QModelIndex parent)
- bool isSelected(QModelIndex index)
- void reset()
- bool rowIntersectsSelection(int row, QModelIndex parent)
- void select(QItemSelection selection, SelectionFlags command)
- void select(QModelIndex index, SelectionFlags command)
- list<var> selectedColumns(int row)
- list<var> selectedRows(int column)
- void setCurrentIndex(QModelIndex index, SelectionFlags command)
Description détaillée
Voir aussi QItemSelectionModel et Modèles et vues dans Qt Quick.
Documentation sur les propriétés
currentIndex : QModelIndex [read-only]
Utilisez setCurrentIndex() pour définir sa valeur.
Voir aussi setCurrentIndex() et currentChanged().
hasSelection : bool [read-only]
Il déclenchera des mises à jour de la liaison des propriétés chaque fois que selectionChanged() sera émis, même si sa valeur n'a pas changé.
Voir aussi selection, selectedIndexes, select(), et selectionChanged().
model : QAbstractItemModel
La valeur de cette propriété doit correspondre au modèle de la vue.
selectedIndexes : list<var> [read-only]
Contient la liste de tous les index (QModelIndex instances) du modèle de sélection.
Voir aussi le type QModelIndexList.
selection : object [read-only]
Contient les plages de sélection stockées dans le modèle de sélection.
Documentation sur les signaux
currentChanged(QModelIndex current, QModelIndex previous)
Ce signal est émis lorsque l'élément courant change. L'index de l'élément du modèle previous est remplacé par l'index current en tant qu'élément courant de la sélection.
Notez que ce signal n'est pas émis lorsque le modèle d'élément est réinitialisé.
Remarque : le gestionnaire correspondant est onCurrentChanged.
Voir aussi currentIndex, setCurrentIndex(), et selectionChanged().
selectionChanged(QItemSelection selected, QItemSelection deselected)
Ce signal est émis lorsque la sélection change. La modification de la sélection est représentée par une sélection d'éléments de deselected et une sélection d'éléments de selected.
Notez que l'indice actuel change indépendamment de la sélection. Notez également que ce signal ne sera pas émis lorsque le modèle d'élément est réinitialisé.
Remarque : le gestionnaire correspondant est onSelectionChanged.
Voir également select() et currentChanged().
Documentation de la méthode
void clear()
Efface le modèle de sélection. Emet selectionChanged() et currentChanged().
void clearCurrentIndex()
Efface l'index actuel. Emet currentChanged().
void clearSelection()
Efface la sélection dans le modèle de sélection. Emet selectionChanged().
bool columnIntersectsSelection(int column, QModelIndex parent)
Renvoie true s'il y a des éléments sélectionnés dans column avec parent.
bool isColumnSelected(int column, QModelIndex parent)
Renvoie true si tous les éléments sont sélectionnés dans la colonne column avec la valeur parent.
Notez que cette fonction est généralement plus rapide que d'appeler isSelected() sur tous les éléments de la même colonne, et que les éléments non sélectionnables sont ignorés.
bool isRowSelected(int row, QModelIndex parent)
Renvoie true si tous les éléments sont sélectionnés dans row avec parent.
Notez que cette fonction est généralement plus rapide que d'appeler isSelected() sur tous les éléments de la même ligne, et que les éléments non sélectionnables sont ignorés.
bool isSelected(QModelIndex index)
Renvoie true si l'article du modèle index est sélectionné.
void reset()
Efface le modèle de sélection. N'émet aucun signal.
bool rowIntersectsSelection(int row, QModelIndex parent)
Renvoie true s'il y a des éléments sélectionnés dans row avec parent.
void select(QItemSelection selection, SelectionFlags command)
Sélectionne l'élément selection à l'aide de la valeur spécifiée command et émet selectionChanged().
Les valeurs valides de command sont décrites dans select(index, command).
void select(QModelIndex index, SelectionFlags command)
Sélectionne l'élément de modèle index à l'aide du paramètre command, et émet selectionChanged().
Les valeurs valables pour le paramètre command sont les suivantes :
| Constante | Description |
|---|---|
NoUpdate | Aucune sélection ne sera effectuée. |
Clear | La sélection complète est effacée. |
Select | Tous les index spécifiés sont sélectionnés. |
Deselect | Tous les index spécifiés sont désélectionnés. |
Toggle | Tous les index spécifiés seront sélectionnés ou désélectionnés en fonction de leur état actuel. |
Current | La sélection actuelle est mise à jour. |
Rows | Tous les index seront développés pour couvrir les lignes. |
Columns | Tous les index seront développés pour couvrir les colonnes. |
SelectCurrent | Une combinaison de Select et Current, fournie pour des raisons de commodité. |
ToggleCurrent | Une combinaison de Toggle et Current, fournie pour des raisons de commodité. |
ClearAndSelect | Une combinaison de Clear et Select, fournie pour des raisons de commodité. |
list<var> selectedColumns(int row)
Renvoie les index (une liste d'instances QModelIndex ) dans le site row donné pour les colonnes où toutes les lignes sont sélectionnées.
Voir aussi selectedRows() et le type QModelIndexList.
list<var> selectedRows(int column)
Renvoie les index (une liste d'instances QModelIndex ) dans le site column donné pour les lignes où toutes les colonnes sont sélectionnées.
Voir aussi selectedColumns() et le type QModelIndexList.
void setCurrentIndex(QModelIndex index, SelectionFlags command)
Définit l'élément de modèle index comme étant l'élément courant et émet currentChanged(). L'élément courant est utilisé pour la navigation au clavier et l'indication du focus ; il est indépendant de tout élément sélectionné, bien qu'un élément sélectionné puisse également être l'élément courant.
En fonction de la valeur spécifiée pour command, l'élément index peut également faire partie de la sélection en cours.
Les valeurs valides de command sont décrites dans select(index, command).
Voir également select().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.