QItemSelectionRange Class
La clase QItemSelectionRange gestiona información sobre un rango de elementos seleccionados en un modelo. Más...
| Cabecera: | #include <QItemSelectionRange> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Esta clase es igual-comparable.
Funciones públicas
| 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 |
No miembros relacionados
| bool | operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
| bool | operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
Descripción Detallada
Un QItemSelectionRange contiene información sobre un rango de elementos seleccionados en un modelo. Un rango de elementos es un array contiguo de elementos del modelo, que se extiende para cubrir un número de filas y columnas adyacentes con un elemento padre común; esto puede visualizarse como un bloque bidimensional de celdas en una tabla. Un rango de selección tiene un top(), left() un bottom(), right() y un parent().
La clase QItemSelectionRange es una de las Clases Modelo/Vista y forma parte del marco modelo/vista de Qt.
Los elementos del modelo contenidos en el rango de selección pueden obtenerse utilizando la función indexes(). Utilice QItemSelectionModel::selectedIndexes() para obtener una lista de todos los elementos seleccionados para una vista.
Puede determinar si un determinado elemento del modelo se encuentra dentro de un rango concreto utilizando la función contains(). Los rangos también pueden compararse utilizando los operadores sobrecargados para igualdad y desigualdad, y la función intersects() permite determinar si dos rangos se solapan.
Véase también Programación Modelo/Vista, QAbstractItemModel, QItemSelection, y QItemSelectionModel.
Documentación de las funciones miembro
[noexcept] QItemSelectionRange::QItemSelectionRange()
Construye un rango de selección vacío.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Construye un nuevo rango de selección que contiene sólo el elemento del modelo especificado por el índice del modelo index.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Construye un nuevo rango de selección que sólo contiene el índice especificado por topLeft y el índice bottomRight.
int QItemSelectionRange::bottom() const
Devuelve el índice de fila correspondiente a la fila seleccionada más baja en el rango de selección.
const QPersistentModelIndex &QItemSelectionRange::bottomRight() const
Devuelve el índice del elemento situado en la esquina inferior derecha del rango de selección.
Véase también bottom(), right() y topLeft().
bool QItemSelectionRange::contains(const QModelIndex &index) const
Devuelve true si el elemento del modelo especificado por index se encuentra dentro del rango de elementos seleccionados; en caso contrario, devuelve false.
bool QItemSelectionRange::contains(int row, int column, const QModelIndex &parentIndex) const
Devuelve true si el elemento del modelo especificado por (row, column) y con parentIndex como elemento padre se encuentra dentro del rango de elementos seleccionados; en caso contrario devuelve false.
Se trata de una función sobrecargada.
int QItemSelectionRange::height() const
Devuelve el número de filas seleccionadas en el rango de selección.
QModelIndexList QItemSelectionRange::indexes() const
Devuelve la lista de elementos de índice de modelo almacenados en la selección.
QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
Devuelve un nuevo rango de selección que contiene sólo los elementos que se encuentran tanto en el rango de selección como en el rango de selección other.
bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
Devuelve true si este rango de selección interseca (se solapa con) el rango other dado; en caso contrario devuelve false.
bool QItemSelectionRange::isEmpty() const
Devuelve true si el rango de selección no contiene ningún elemento o sólo elementos desactivados o marcados como no seleccionables.
bool QItemSelectionRange::isValid() const
Devuelve true si el rango de selección es válido; en caso contrario devuelve false.
int QItemSelectionRange::left() const
Devuelve el índice de columna correspondiente a la columna seleccionada más a la izquierda en el rango de selección.
const QAbstractItemModel *QItemSelectionRange::model() const
Devuelve el modelo al que pertenecen los elementos del rango de selección.
QModelIndex QItemSelectionRange::parent() const
Devuelve el índice del elemento del modelo padre de los elementos del rango de selección.
int QItemSelectionRange::right() const
Devuelve el índice de columna correspondiente a la columna seleccionada más a la derecha en el rango de selección.
[noexcept] void QItemSelectionRange::swap(QItemSelectionRange &other)
Intercambia el contenido de este rango de selección con other. Esta operación es muy rápida y nunca falla.
int QItemSelectionRange::top() const
Devuelve el índice de fila correspondiente a la fila seleccionada más alta en el rango de selección.
const QPersistentModelIndex &QItemSelectionRange::topLeft() const
Devuelve el índice del elemento situado en la esquina superior izquierda del rango de selección.
Véase también top(), left() y bottomRight().
int QItemSelectionRange::width() const
Devuelve el número de columnas seleccionadas en el rango de selección.
No miembros relacionados
[noexcept] bool operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Devuelve true si el rango de selección lhs difiere del rango rhs dado; en caso contrario devuelve false.
[noexcept] bool operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Devuelve true si el rango de selección lhs es exactamente igual al rango rhs dado; en caso contrario devuelve 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.
