En esta página

ItemSelectionModel QML Type

Crea una instancia de ` QItemSelectionModel ` para utilizarla junto con un ` QAbstractItemModel ` y cualquier vista que lo admita. Más...

Import Statement: import QtQml.Models
In C++: QItemSelectionModel

Propiedades

Señales

Métodos

Descripción detallada

Véase también « QItemSelectionModel » y «Modelos y vistas» en Qt Quick.

Documentación de propiedades

currentIndex : QModelIndex [read-only]

Utiliza setCurrentIndex() para establecer su valor.

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

hasSelection : bool [read-only]

Esto activará actualizaciones en los enlaces de propiedades cada vez que se emita selectionChanged(), aunque su valor no haya cambiado.

Véase también selection, selectedIndexes, select() y selectionChanged().

model : QAbstractItemModel

El valor de esta propiedad debe coincidir con el modelo de la vista.

selectedIndexes : list<var> [read-only]

Contiene la lista de todos los índices (instancias de `QModelIndex `) del modelo de selección.

Véase también el tipo QModelIndexList.

selection : object [read-only]

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

Documentación de señales

currentChanged(QModelIndex current, 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 del elemento.

Nota: El controlador correspondiente es onCurrentChanged.

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

selectionChanged(QItemSelection selected, 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 reinicie el modelo de elementos.

Nota: El controlador correspondiente es onSelectionChanged.

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

Documentación del método

void clear()

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

void clearCurrentIndex()

Borra el índice actual. Emite la función « currentChanged()».

void clearSelection()

Borra la selección del modelo de selección. Emite un evento « selectionChanged()».

bool columnIntersectsSelection(int column, QModelIndex parent)

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

bool isColumnSelected(int column, QModelIndex parent)

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.

bool isRowSelected(int row, QModelIndex parent)

Devuelve ` true ` si todos los elementos están seleccionados en la ` 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 los elementos que no se pueden seleccionar se ignoran.

bool isSelected(QModelIndex index)

Devuelve « true » si se selecciona el elemento del modelo indicado index.

void reset()

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

bool rowIntersectsSelection(int row, QModelIndex parent)

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

void select(QItemSelection selection, SelectionFlags command)

Selecciona el elemento selection utilizando el command especificado y devuelve selectionChanged().

Los valores válidos de ` command ` se describen en select(index, command).

void select(QModelIndex index, SelectionFlags command)

Selecciona el elemento del modelo « index » utilizando el valor especificado en « command », y devuelve « selectionChanged()».

Los valores válidos para el parámetro ` command ` son:

ConstanteDescripción
NoUpdateNo se realizará ninguna selección.
ClearSe borrará toda la selección.
SelectSe seleccionarán todos los índices especificados.
DeselectSe deseleccionarán todos los índices especificados.
ToggleSe seleccionarán o deseleccionarán todos los índices especificados en función de su estado actual.
CurrentSe actualizará la selección actual.
RowsTodos los índices se ampliarán para abarcar filas.
ColumnsTodos los índices se ampliarán para abarcar columnas.
SelectCurrentUna combinación de «Seleccionar» y «Actual», que se ofrece por comodidad.
ToggleCurrentUna combinación de «Alternar» y «Actual», que se ofrece por comodidad.
ClearAndSelectUna combinación de «Borrar» y «Seleccionar», ofrecida para mayor comodidad.

list<var> selectedColumns(int row)

Devuelve los índices (una lista de instancias de ` QModelIndex `) en el ` row ` indicado para las columnas en las que se han seleccionado todas las filas.

Véase también selectedRows() y el tipo QModelIndexList.

list<var> selectedRows(int column)

Devuelve los índices (una lista de instancias de ` QModelIndex `) en el ` column ` indicado para las filas en las que se han seleccionado todas las columnas.

Véase también selectedColumns() y el tipo QModelIndexList.

void setCurrentIndex(QModelIndex index, 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 para indicar el 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.

Los valores válidos de ` command ` se describen en select(index, command).

Véase también select().

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