QItemSelectionRange Class
La clase QItemSelectionRange gestiona la información relativa a un rango de elementos seleccionados en un modelo. Más información...
| Encabezado: | #include <QItemSelectionRange> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Comparaciones de QItemSelectionRange
| Categoría | Tipos comparables |
|---|---|
| igualdad | QItemSelectionRange |
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 |
Elementos 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 una matriz contigua de elementos del modelo, que se extiende para abarcar varias 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 de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.
Los elementos del modelo contenidos en el rango de selección se pueden obtener mediante la función indexes(). Utiliza QItemSelectionModel::selectedIndexes() para obtener una lista de todos los elementos seleccionados de una vista.
Se puede determinar si un elemento del modelo determinado se encuentra dentro de un rango concreto utilizando la función ` contains()`. Los rangos también se pueden comparar utilizando los operadores sobrecargados de igualdad y desigualdad, y la función ` intersects()` permite determinar si dos rangos se solapan.
Véase también Programación de modelos y vistas, ` QAbstractItemModel`, ` QItemSelection` y ` QItemSelectionModel`.
Documentación de las funciones miembro
[noexcept default] QItemSelectionRange::QItemSelectionRange()
Crea un rango de selección vacío.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Crea un nuevo rango de selección que contiene únicamente el elemento del modelo especificado por el índice de modelo index.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Crea un nuevo rango de selección que contiene únicamente el índice especificado por « topLeft » y el índice « bottomRight ».
int QItemSelectionRange::bottom() const
Devuelve el índice de la fila que corresponde a la fila seleccionada situada más abajo 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 cuyo elemento padre es ` parentIndex ` se encuentra dentro del rango de elementos seleccionados; en caso contrario, devuelve ` false`.
Esta es 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 del índice del modelo almacenados en la selección.
QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
Devuelve un nuevo rango de selección que contiene únicamente 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 se cruza (se solapa) con el rango « other » indicado; en caso contrario, devuelve « false ».
bool QItemSelectionRange::isEmpty() const
Devuelve « true » si el rango de selección no contiene ningún elemento o solo contiene 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 la columna que corresponde a la columna seleccionada más a la izquierda del 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 principal correspondiente a los elementos del rango de selección.
int QItemSelectionRange::right() const
Devuelve el índice de la columna correspondiente a la columna seleccionada situada más a la derecha en el rango de selección.
[noexcept] void QItemSelectionRange::swap(QItemSelectionRange &other)
Intercambia el contenido de este rango seleccionado con other. Esta operación es muy rápida y nunca falla.
int QItemSelectionRange::top() const
Devuelve el índice de la fila correspondiente a la fila seleccionada más alta del 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.
Elementos no miembros relacionados
[noexcept] bool operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Devuelve « true » si el rango de selección de « lhs » difiere del rango de « rhs » indicado; en caso contrario, devuelve « false ».
[noexcept] bool operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Devuelve « true » si el rango de selección de « lhs » es exactamente el mismo que el rango de « rhs » indicado; 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.