En esta página

QItemSelection Class

La clase QItemSelection gestiona la información sobre los elementos seleccionados en un modelo. Más información...

Encabezado: #include <QItemSelection>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredan: QList

Funciones públicas

QItemSelection()
QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight)
bool contains(const QModelIndex &index) const
QModelIndexList indexes() const
void merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)
void select(const QModelIndex &topLeft, const QModelIndex &bottomRight)

Miembros públicos estáticos

void split(const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result)

Descripción detallada

Un QItemSelection describe los elementos de un modelo que han sido seleccionados por el usuario. Un QItemSelection es, básicamente, una lista de rangos de selección; véase QItemSelectionRange. Proporciona funciones para crear y manipular selecciones, así como para seleccionar un rango de elementos de un modelo.

La clase QItemSelection es una de las clases de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.

Se puede crear e inicializar una selección de elementos para que contenga un rango de elementos de un modelo existente. El siguiente ejemplo crea una selección que contiene un rango de elementos del modelo dado model, que comienza en topLeft y termina en bottomRight.

QItemSelection *selection = new QItemSelection(topLeft, bottomRight);

Se puede crear una selección de elementos vacía y rellenarla posteriormente según sea necesario. Así pues, si el modelo no va a estar disponible cuando creemos la selección de elementos, podemos reescribir el código anterior de la siguiente manera:

QItemSelection *selection = new QItemSelection();
//...
selection->select(topLeft, bottomRight);

QItemSelection ahorra memoria y evita trabajo innecesario al trabajar con rangos de selección en lugar de registrar el índice del elemento del modelo para cada elemento de la selección. Por lo general, una instancia de esta clase contendrá una lista de rangos de selección que no se solapan.

Utiliza ` merge()` para fusionar una selección de elementos con otra sin crear rangos que se solapen. Utiliza ` split()` para dividir un rango de selección en rangos más pequeños basándote en otro rango de selección.

Véase también Programación demodelo/vista y QItemSelectionModel.

Documentación de funciones de miembro

[implicit] QItemSelection::QItemSelection()

Crea una selección vacía.

QItemSelection::QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight)

Crea una selección de elementos que se extiende desde el elemento del modelo situado en la esquina superior izquierda, especificado por el índice topLeft, hasta el elemento situado en la esquina inferior derecha, especificado por bottomRight.

bool QItemSelection::contains(const QModelIndex &index) const

Devuelve ` true ` si la selección contiene el valor dado ` index`; en caso contrario, devuelve ` false`.

QModelIndexList QItemSelection::indexes() const

Devuelve una lista de los índices de los modelos que corresponden a los elementos seleccionados.

void QItemSelection::merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)

Combina la selección de other con esta de QItemSelection utilizando el command indicado. Este método garantiza que no haya rangos que se solapen.

Ten en cuenta que solo se admiten los tipos « QItemSelectionModel::Select », « QItemSelectionModel::Deselect » y « QItemSelectionModel::Toggle ».

Véase también split().

void QItemSelection::select(const QModelIndex &topLeft, const QModelIndex &bottomRight)

Añade a la lista los elementos del rango que se extiende desde el elemento del modelo situado en la esquina superior izquierda, especificado por el índice topLeft, hasta el elemento situado en la esquina inferior derecha, especificado por bottomRight.

Nota: topLeft y bottomRight deben tener el mismo elemento padre.

[static] void QItemSelection::split(const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result)

Divide la selección range utilizando el rango de selección other. Elimina todos los elementos de other de range y coloca el resultado en result. Esto puede compararse con la semántica de la operación de sustracción de un conjunto.

Véase también merge().

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