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
- 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]
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:
| 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 expandirán para abarcar las filas. |
Columns | Todos los índices se expandirán para abarcar columnas. |
SelectCurrent | Una combinación de Seleccionar y Actual, proporcionada por conveniencia. |
ToggleCurrent | Una combinación de Alternar y Actual, proporcionada por conveniencia. |
ClearAndSelect | Una 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.