En esta página

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íaTipos comparables
igualdadQItemSelectionRange

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
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.

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.