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
- selectedIndexes : QModelIndexList
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 ¤t, const QModelIndex &previous) |
| void | currentColumnChanged(const QModelIndex ¤t, const QModelIndex &previous) |
| void | currentRowChanged(const QModelIndex ¤t, 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.
| Constante | Valor | Descripción |
|---|---|---|
QItemSelectionModel::NoUpdate | 0x0000 | No se realizará ninguna selección. |
QItemSelectionModel::Clear | 0x0001 | Se borrará toda la selección. |
QItemSelectionModel::Select | 0x0002 | Se seleccionarán todos los índices especificados. |
QItemSelectionModel::Deselect | 0x0004 | Se deseleccionarán todos los índices especificados. |
QItemSelectionModel::Toggle | 0x0008 | Se seleccionarán o deseleccionarán todos los índices especificados en función de su estado actual. |
QItemSelectionModel::Current | 0x0010 | Se actualizará la selección actual. |
QItemSelectionModel::Rows | 0x0020 | Todos los índices se ampliarán para abarcar filas. |
QItemSelectionModel::Columns | 0x0040 | Todos los índices se ampliarán para abarcar columnas. |
QItemSelectionModel::SelectCurrent | Select | Current | Una combinación de «Seleccionar» y «Actual», ofrecida para mayor comodidad. |
QItemSelectionModel::ToggleCurrent | Toggle | Current | Una combinación de «Alternar» y «Actual», que se ofrece para mayor comodidad. |
QItemSelectionModel::ClearAndSelect | Clear | Select | Una 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 ¤t, 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 ¤t, 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 ¤t, 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); }); 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); }); 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.