QItemSelectionRange Class
La classe `QItemSelectionRange` gère les informations relatives à une plage d'éléments sélectionnés dans un modèle. En savoir plus...
| En-tête : | #include <QItemSelectionRange> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
Comparaisons de QItemSelectionRange
| Catégorie | Types comparables |
|---|---|
| égalité | QItemSelectionRange |
Fonctions publiques
| QItemSelectionRange() | |
| QItemSelectionRange(const QModelIndex &index) | |
| QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight) | |
| int | bottom() const |
| const QPersistentModelIndex & | bottomRight() const |
| bool | contains(const QModelIndex &index) const |
| bool | contains(int row, int column, const QModelIndex &parentIndex) const |
| int | height() const |
| QModelIndexList | indexes() const |
| QItemSelectionRange | intersected(const QItemSelectionRange &other) const |
| bool | intersects(const QItemSelectionRange &other) const |
| bool | isEmpty() const |
| bool | isValid() const |
| int | left() const |
| const QAbstractItemModel * | model() const |
| QModelIndex | parent() const |
| int | right() const |
| void | swap(QItemSelectionRange &other) |
| int | top() const |
| const QPersistentModelIndex & | topLeft() const |
| int | width() const |
Éléments non membres associés
| bool | operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
| bool | operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
Description détaillée
Un QItemSelectionRange contient des informations sur une plage d'éléments sélectionnés dans un modèle. Une plage d’éléments est un tableau contigu d’éléments du modèle, s’étendant sur un certain nombre de lignes et de colonnes adjacentes ayant un élément parent commun ; cela peut être visualisé comme un bloc bidimensionnel de cellules dans un tableau. Une plage de sélection possède une méthode « top » (), « left » (), « bottom » (), « right » () et « parent » ().
La classe QItemSelectionRange fait partie des classes Modèle/Vue et s'inscrit dans le cadre modèle/vue de Qt.
Les éléments du modèle contenus dans la plage de sélection peuvent être obtenus à l’aide de la fonction ` indexes()`. Utilisez ` QItemSelectionModel::selectedIndexes()` pour obtenir la liste de tous les éléments sélectionnés dans une vue.
Vous pouvez déterminer si un élément de modèle donné se trouve dans une plage particulière à l’aide de la fonction ` contains()`. Les plages peuvent également être comparées à l’aide des opérateurs surchargés d’égalité et d’inégalité, et la fonction ` intersects()` vous permet de déterminer si deux plages se chevauchent.
Voir également Programmation modèle/vue, QAbstractItemModel, QItemSelection et QItemSelectionModel.
Documentation sur les fonctions membres
[noexcept default] QItemSelectionRange::QItemSelectionRange()
Crée une plage de sélection vide.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Crée une nouvelle plage de sélection ne contenant que l'élément du modèle spécifié par l'index de modèle index.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Crée une nouvelle plage de sélection ne contenant que l'index spécifié par l'topLeft et l'index bottomRight.
int QItemSelectionRange::bottom() const
Renvoie l'index de la ligne correspondant à la ligne la plus basse de la plage sélectionnée.
const QPersistentModelIndex &QItemSelectionRange::bottomRight() const
Renvoie l'index de l'élément situé dans le coin inférieur droit de la plage sélectionnée.
Voir également bottom(), right() et topLeft().
bool QItemSelectionRange::contains(const QModelIndex &index) const
Renvoie « true » si l’élément du modèle spécifié par « index » se trouve dans la plage des éléments sélectionnés ; sinon, renvoie « false ».
bool QItemSelectionRange::contains(int row, int column, const QModelIndex &parentIndex) const
Renvoie « true » si l'élément du modèle spécifié par (row, column) et dont l'élément parent est parentIndex se trouve dans la plage des éléments sélectionnés ; sinon, renvoie « false ».
Il s'agit d'une fonction surchargée.
int QItemSelectionRange::height() const
Renvoie le nombre de lignes sélectionnées dans la plage de sélection.
QModelIndexList QItemSelectionRange::indexes() const
Renvoie la liste des éléments d'index du modèle enregistrés dans la sélection.
QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
Renvoie une nouvelle plage de sélection contenant uniquement les éléments présents à la fois dans la plage de sélection initiale et dans la plage de sélection « other ».
bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
Renvoie « true » si cette plage de sélection recoupe (chevauche) la plage « other » indiquée ; sinon, renvoie « false ».
bool QItemSelectionRange::isEmpty() const
Renvoie « true » si la plage de sélection ne contient aucun élément ou uniquement des éléments désactivés ou marqués comme non sélectionnables.
bool QItemSelectionRange::isValid() const
Renvoie « true » si la plage de sélection est valide ; sinon, renvoie « false ».
int QItemSelectionRange::left() const
Renvoie l'index de la colonne correspondant à la colonne la plus à gauche de la plage sélectionnée.
const QAbstractItemModel *QItemSelectionRange::model() const
Renvoie le modèle auquel appartiennent les éléments de la plage sélectionnée.
QModelIndex QItemSelectionRange::parent() const
Renvoie l'index de l'élément de modèle parent des éléments compris dans la plage de sélection.
int QItemSelectionRange::right() const
Renvoie l'index de la colonne correspondant à la colonne sélectionnée la plus à droite dans la plage de sélection.
[noexcept] void QItemSelectionRange::swap(QItemSelectionRange &other)
Permute le contenu de cette plage de sélection avec celui de other. Cette opération est très rapide et ne rencontre jamais d'échec.
int QItemSelectionRange::top() const
Renvoie l'index de la ligne correspondant à la ligne sélectionnée la plus haute dans la plage de sélection.
const QPersistentModelIndex &QItemSelectionRange::topLeft() const
Renvoie l'index de l'élément situé dans le coin supérieur gauche de la plage sélectionnée.
Voir également top(), left() et bottomRight().
int QItemSelectionRange::width() const
Renvoie le nombre de colonnes sélectionnées dans la plage de sélection.
Éléments connexes non membres
[noexcept] bool operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Renvoie « true » si la plage de sélection de lhs diffère de celle indiquée sur rhs; sinon, renvoie « false ».
[noexcept] bool operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Renvoie « true » si la plage de sélection lhs correspond exactement à la plage rhs fournie ; sinon, renvoie « false ».
© 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.
