En esta página

QItemSelectionModel Class

La clase `QItemSelectionModel` lleva un registro de los elementos seleccionados de una vista. Más información...

Encabezado: #include <QItemSelectionModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QObject

Tipos públicos

enum SelectionFlag { NoUpdate, Clear, Select, Deselect, Toggle, …, ClearAndSelect }
flags SelectionFlags

Propiedades

Funciones públicas

QItemSelectionModel(QAbstractItemModel *model = nullptr)
QItemSelectionModel(QAbstractItemModel *model, QObject *parent)
virtual ~QItemSelectionModel()
bool columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const
QModelIndex currentIndex() const
bool hasSelection() const
bool isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const
bool isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const
bool isSelected(const QModelIndex &index) const
QAbstractItemModel *model()
const QAbstractItemModel *model() const
bool rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const
QModelIndexList selectedColumns(int row = 0) const
QModelIndexList selectedIndexes() const
QModelIndexList selectedRows(int column = 0) const
const QItemSelection selection() const
void setModel(QAbstractItemModel *model)

Ranuras públicas

virtual void clear()
virtual void clearCurrentIndex()
void clearSelection()
virtual void reset()
virtual void select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)
virtual void select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)
virtual void setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Señales

void currentChanged(const QModelIndex &current, const QModelIndex &previous)
void currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)
void currentRowChanged(const QModelIndex &current, const QModelIndex &previous)
void modelChanged(QAbstractItemModel *model)
void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Funciones protegidas

void emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

Descripción detallada

Un QItemSelectionModel realiza un seguimiento de los elementos seleccionados en una vista, o en varias vistas que se refieren al mismo modelo. También realiza un seguimiento del elemento seleccionado actualmente en una vista.

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

Los elementos seleccionados se almacenan mediante rangos. Siempre que se desee modificar los elementos seleccionados, se debe utilizar ` select()` y proporcionar un ` QItemSelection`, o bien un ` QModelIndex ` y un ` QItemSelectionModel::SelectionFlag`.

El QItemSelectionModel adopta un enfoque de dos niveles para la gestión de la selección, ocupándose tanto de los elementos seleccionados que se han confirmado como de los que forman parte de la selección actual. Los elementos seleccionados actualmente forman parte de la selección interactiva actual (por ejemplo, con la selección de «goma elástica» o las selecciones con la tecla Mayús del teclado).

Para actualizar los elementos seleccionados actualmente, utilice la operación OR bit a bit de ` QItemSelectionModel::Current ` y cualquiera de los demás ` SelectionFlags`. Si omite el comando ` QItemSelectionModel::Current `, se creará una nueva selección actual y la anterior se añadirá a la selección global. Todas las funciones operan en ambas capas; por ejemplo, ` selecteditems()` devolverá elementos de ambas capas.

Nota: Desde la versión 5.5, model, hasSelection y currentIndex son propiedades de metaobjetos.

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

Documentación sobre tipos de miembros

enum QItemSelectionModel::SelectionFlag
flags QItemSelectionModel::SelectionFlags

Esta enumeración describe la forma en que se actualizará el modelo de selección.

ConstanteValorDescripción
QItemSelectionModel::NoUpdate0x0000No se realizará ninguna selección.
QItemSelectionModel::Clear0x0001Se borrará toda la selección.
QItemSelectionModel::Select0x0002Se seleccionarán todos los índices especificados.
QItemSelectionModel::Deselect0x0004Se deseleccionarán todos los índices especificados.
QItemSelectionModel::Toggle0x0008Se seleccionarán o deseleccionarán todos los índices especificados en función de su estado actual.
QItemSelectionModel::Current0x0010Se actualizará la selección actual.
QItemSelectionModel::Rows0x0020Todos los índices se ampliarán para abarcar filas.
QItemSelectionModel::Columns0x0040Todos los índices se ampliarán para abarcar columnas.
QItemSelectionModel::SelectCurrentSelect | CurrentUna combinación de «Seleccionar» y «Actual», ofrecida para mayor comodidad.
QItemSelectionModel::ToggleCurrentToggle | CurrentUna combinación de «Alternar» y «Actual», que se ofrece para mayor comodidad.
QItemSelectionModel::ClearAndSelectClear | SelectUna combinación de «Clear» y «Select», incluida por comodidad.

El tipo SelectionFlags es un typedef de QFlags<SelectionFlag>. Almacena una combinación OR de valores de SelectionFlag.

Documentación de la propiedad

[read-only] selectedIndexes : QModelIndexList

Funciones de acceso:

QModelIndexList selectedIndexes() const

Señal de notificación:

void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Documentación de las funciones miembro

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

Crea un modelo de selección que opera sobre el elemento especificado model.

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

Crea un modelo de selección que opera sobre el elemento especificado model con parent.

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

Elimina el modelo de selección.

[virtual slot] void QItemSelectionModel::clear()

Borra el modelo de selección. Emite los métodos selectionChanged() y currentChanged().

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

Borra el índice actual. Emite « currentChanged()».

[slot] void QItemSelectionModel::clearSelection()

Borra la selección del modelo de selección. Emite selectionChanged().

[invokable] bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const

Devuelve ` true ` si hay algún elemento seleccionado en ` column ` con el ` parent` indicado.

Nota: A partir de Qt 5.15, el argumento por defecto para ` parent ` es un índice de modelo vacío.

Nota: Esta función se puede invocar a través del sistema de metaoobjetos y desde QML. Véase Q_INVOKABLE.

[signal] void QItemSelectionModel::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite cada vez que cambia el elemento actual. El índice del elemento del modelo « previous » se sustituye por el índice « current » como elemento actual de la selección.

Ten en cuenta que esta señal no se emitirá cuando se restablezca el modelo de elemento.

Véanse también currentIndex(), setCurrentIndex() y selectionChanged().

[signal] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite si el elemento « current » cambia y su columna es diferente a la del elemento actual « previous ».

Ten en cuenta que esta señal no se emitirá cuando se restablezca el modelo del elemento.

Véanse también currentChanged(), currentRowChanged(), currentIndex() y setCurrentIndex().

QModelIndex QItemSelectionModel::currentIndex() const

Devuelve el índice del elemento del modelo correspondiente al elemento actual, o un índice no válido si no hay ningún elemento actual.

Véase también setCurrentIndex().

[signal] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite si el elemento « current » cambia y su fila es diferente a la del elemento actual « previous ».

Ten en cuenta que esta señal no se emitirá cuando se restablezca el modelo del elemento.

Véanse también currentChanged(), currentColumnChanged(), currentIndex() y setCurrentIndex().

[protected] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

Compara las dos selecciones newSelection y oldSelection y devuelve selectionChanged() con los elementos deseleccionados y seleccionados.

bool QItemSelectionModel::hasSelection() const

Devuelve « true » si el modelo de selección contiene algún elemento seleccionado; en caso contrario, devuelve « false ».

[invokable] bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const

Devuelve ` true ` si se han seleccionado todos los elementos de la columna ` column ` con el valor ` parent` indicado.

Ten en cuenta que esta función suele ser más rápida que llamar a ` isSelected()` en todos los elementos de la misma columna y que se ignoran los elementos que no se pueden seleccionar.

Nota: A partir de Qt 5.15, el argumento por defecto para parent es un índice de modelo vacío.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const

Devuelve ` true ` si todos los elementos están seleccionados en ` row ` con el ` parent` indicado.

Ten en cuenta que esta función suele ser más rápida que llamar a ` isSelected()` en todos los elementos de la misma fila y que se ignoran los elementos que no se pueden seleccionar.

Nota: A partir de Qt 5.15, el argumento por defecto para parent es un índice de modelo vacío.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

Devuelve ` true ` si el elemento del modelo indicado index está seleccionado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QAbstractItemModel *QItemSelectionModel::model()

Devuelve el modelo de elemento sobre el que actúa el modelo de selección.

Véase también setModel().

const QAbstractItemModel *QItemSelectionModel::model() const

Devuelve el modelo de elemento sobre el que actúa el modelo de selección.

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

Esta señal se emite cuando se establece correctamente el ` model ` con ` setModel()`.

Véanse también model() y setModel().

[virtual slot] void QItemSelectionModel::reset()

Borra el modelo de selección. No emite ninguna señal.

[invokable] bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const

Devuelve ` true ` si hay algún elemento seleccionado en ` row ` con el ` parent` indicado.

Nota: Desde Qt 5.15, el argumento por defecto para parent es un índice de modelo vacío.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

Selecciona el elemento « selection » utilizando el « command » especificado y emite « selectionChanged()».

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) { receiver->select(selection, command); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

Véase también « QItemSelectionModel::SelectionFlag ».

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Selecciona el elemento del modelo index utilizando el command especificado, y emite selectionChanged().

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QModelIndex &index, QItemSelectionModel::SelectionFlags command) { receiver->select(index, command); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

Véase también QItemSelectionModel::SelectionFlags.

[invokable] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

Devuelve los índices del objeto « row » indicado para las columnas en las que se han seleccionado todas las filas.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también selectedIndexes() y selectedRows().

QModelIndexList QItemSelectionModel::selectedIndexes() const

Devuelve una lista con todos los índices de los elementos del modelo seleccionados. La lista no contiene duplicados y no está ordenada.

Nota: Funcióngetter para la propiedad selectedIndexes.

[invokable] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

Devuelve los índices de la tabla « column » indicada correspondientes a las filas en las que se han seleccionado todas las columnas.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también ` selectedIndexes()` y ` selectedColumns()`.

const QItemSelection QItemSelectionModel::selection() const

Devuelve los rangos de selección almacenados en el modelo de selección.

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Esta señal se emite cada vez que cambia la selección. El cambio en la selección se representa como una selección de elementos de deselected y una selección de elementos de selected.

Ten en cuenta que el índice actual cambia independientemente de la selección. Ten en cuenta también que esta señal no se emitirá cuando se restablezca el modelo de elementos.

Los elementos que permanecen seleccionados pero cambian de índice no se incluyen en selected ni en deselected. Por lo tanto, esta señal podría emitirse con selected y deselected vacíos, si solo cambian los índices de los elementos seleccionados.

Nota: Noestá permitido modificar el modelo (por ejemplo, llamando a setData()) desde una ranura conectada directamente a esta señal. Esta señal puede emitirse mientras el modelo se está modificando, por ejemplo, durante la eliminación de filas o columnas, o durante un reinicio del modelo. Intentar realizar cambios adicionales en esos momentos puede dar lugar a un comportamiento indefinido. En particular, las modificaciones anidadas pueden corromper el estado interno, como las estructuras de mapeo mantenidas por QSortFilterProxyModel.

Nota: Señalde notificación para la propiedad selectedIndexes.

Véase también select() y currentChanged().

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Establece el elemento del modelo « index » como elemento actual y emite « currentChanged()». El elemento actual se utiliza para la navegación mediante el teclado y la indicación del foco; es independiente de cualquier elemento seleccionado, aunque un elemento seleccionado también puede ser el elemento actual.

Dependiendo del command especificado, el index también puede pasar a formar parte de la selección actual.

Véanse también currentIndex() y select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Establece el modelo en « model ». Se emitirá la señal « modelChanged()».

Véase también model() y modelChanged().

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