QItemSelectionRange Class
La classe QItemSelectionRange gère les informations relatives à une plage d'éléments sélectionnés dans un modèle. Plus d'informations...
| En-tête : | #include <QItemSelectionRange> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
Cette classe est comparable à l'égalité.
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 |
Non-membres apparenté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 de modèle, s'étendant pour couvrir un certain nombre de lignes et de colonnes adjacentes avec 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 un top(), un left(), un bottom(), un right() et un parent().
La classe QItemSelectionRange est l'une des classes Modèle/Vue et fait partie du 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 la fonction QItemSelectionModel::selectedIndexes() pour obtenir une liste de tous les éléments sélectionnés pour 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] QItemSelectionRange::QItemSelectionRange()
Construit une plage de sélection vide.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Construit une nouvelle plage de sélection contenant uniquement l'élément de modèle spécifié par l'index de modèle index.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Construit une nouvelle plage de sélection contenant uniquement l'index spécifié par topLeft et l'index bottomRight.
int QItemSelectionRange::bottom() const
Renvoie l'indice de ligne correspondant à la ligne sélectionnée la plus basse dans la plage de sélection.
const QPersistentModelIndex &QItemSelectionRange::bottomRight() const
Renvoie l'index de l'élément situé dans le coin inférieur droit de la plage de sélection.
Voir aussi 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 gamme 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 de modèle spécifié par (row, column) et dont l'élément parent est parentIndex se trouve dans l'intervalle 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 de l'index du modèle stockés dans la sélection.
QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
Renvoie une nouvelle plage de sélection contenant uniquement les éléments qui se trouvent à la fois dans la plage de sélection et dans la plage de sélection other.
bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
Renvoie true si cette plage de sélection intersecte (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'indice de colonne correspondant à la colonne sélectionnée la plus à gauche dans la plage de sélection.
const QAbstractItemModel *QItemSelectionRange::model() const
Renvoie le modèle auquel appartiennent les éléments de la plage de sélection.
QModelIndex QItemSelectionRange::parent() const
Renvoie l'indice de l'élément du modèle parent des éléments de la plage de sélection.
int QItemSelectionRange::right() const
Renvoie l'indice de colonne correspondant à la colonne sélectionnée la plus à droite dans la plage de sélection.
[noexcept] void QItemSelectionRange::swap(QItemSelectionRange &other)
Remplace le contenu de cette plage de sélection par celui de other. Cette opération est très rapide et n'échoue jamais.
int QItemSelectionRange::top() const
Renvoie l'indice de 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 de sélection.
Voir aussi top(), left() et bottomRight().
int QItemSelectionRange::width() const
Renvoie le nombre de colonnes sélectionnées dans la plage de sélection.
Non-membres apparentés
[noexcept] bool operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Renvoie true si la plage de sélection lhs diffère de la plage rhs indiquée ; sinon, renvoie false.
[noexcept] bool operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Renvoie true si la plage de sélection de lhs est exactement la même que celle de rhs; 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.
