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
- currentIndex : QModelIndex
- hasSelection : bool
- model : QAbstractItemModel
- selectedIndexes : list<var>
- selection : object
Señales
- currentChanged(QModelIndex current, QModelIndex previous)
- selectionChanged(QItemSelection selected, QItemSelection deselected)
Métodos
- void clear()
- void clearCurrentIndex()
- void clearSelection()
- bool columnIntersectsSelection(int column, QModelIndex parent)
- bool isColumnSelected(int column, QModelIndex parent)
- bool isRowSelected(int row, QModelIndex parent)
- bool isSelected(QModelIndex index)
- void reset()
- bool rowIntersectsSelection(int row, QModelIndex parent)
- void select(QItemSelection selection, SelectionFlags command)
- void select(QModelIndex index, SelectionFlags command)
- list<var> selectedColumns(int row)
- list<var> selectedRows(int column)
- void setCurrentIndex(QModelIndex index, SelectionFlags command)
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:
| Constante | Descripción |
|---|---|
NoUpdate | No se realizará ninguna selección. |
Clear | Se borrará toda la selección. |
Select | Se seleccionarán todos los índices especificados. |
Deselect | Se deseleccionarán todos los índices especificados. |
Toggle | Se seleccionarán o deseleccionarán todos los índices especificados en función de su estado actual. |
Current | Se actualizará la selección actual. |
Rows | Todos los índices se ampliarán para abarcar filas. |
Columns | Todos los índices se ampliarán para abarcar columnas. |
SelectCurrent | Una combinación de «Seleccionar» y «Actual», que se ofrece por comodidad. |
ToggleCurrent | Una combinación de «Alternar» y «Actual», que se ofrece por comodidad. |
ClearAndSelect | Una 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.