En esta página

ItemSelectionModel QML Type

Instancia de un QItemSelectionModel que se utilizará junto con un QAbstractItemModel y cualquier vista que lo soporte. 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]

Utilice setCurrentIndex() para fijar su valor.

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

hasSelection : bool [read-only]

Activará la actualización del enlace 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 (QModelIndex instances) 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.

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

Nota: El manejador 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 elementos y una selección de elementos de selected elementos.

Tenga en cuenta que el índice actual cambia independientemente de la selección. Observe también que esta señal no se emitirá cuando se reinicie el modelo de ítems.

Nota: El manejador correspondiente es onSelectionChanged.

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

Documentación del método

void clear()

Borra el modelo de selección. Emite selectionChanged() y currentChanged().

void clearCurrentIndex()

Borra el índice actual. Emite currentChanged().

void clearSelection()

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

bool columnIntersectsSelection(int column, QModelIndex parent)

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

bool isColumnSelected(int column, QModelIndex parent)

Devuelve true si todos los elementos están seleccionados en column con el parent dado.

Tenga 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 los elementos no seleccionables se ignoran.

bool isRowSelected(int row, QModelIndex parent)

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

Tenga 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 no seleccionables se ignoran.

bool isSelected(QModelIndex index)

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

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

void select(QItemSelection selection, SelectionFlags command)

Selecciona el elemento selection utilizando el valor especificado command, y emite 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 parámetro especificado command, y emite 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 expandirán para abarcar las filas.
ColumnsTodos los índices se expandirán para abarcar columnas.
SelectCurrentUna combinación de Seleccionar y Actual, proporcionada por conveniencia.
ToggleCurrentUna combinación de Alternar y Actual, proporcionada por conveniencia.
ClearAndSelectUna combinación de Borrar y Seleccionar, proporcionada por conveniencia.

list<var> selectedColumns(int row)

Devuelve los índices (una lista de instancias de QModelIndex ) en el row dado para columnas donde todas las filas están seleccionadas.

Véase también selectedRows() y QModelIndexList Type.

list<var> selectedRows(int column)

Devuelve los índices (una lista de instancias de QModelIndex ) en el column dado para las filas en las que todas las columnas están seleccionadas.

Véase también selectedColumns() y QModelIndexList Type.

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 por teclado y la indicación de 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 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.