ItemSelectionModel QML Type

Instancie un objet « QItemSelectionModel » destiné à être utilisé conjointement avec un « QAbstractItemModel » et toute vue le prenant en charge. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• currentIndex : QModelIndex
• hasSelection : bool
• model : QAbstractItemModel
• selectedIndexes : list<var>
• selection : object

Signaux

• currentChanged(QModelIndex current, QModelIndex previous)
• selectionChanged(QItemSelection selected, QItemSelection deselected)

Méthodes

• 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)

Description détaillée

Voir également « QItemSelectionModel » et «Modèles et vues» sur Qt Quick.

Documentation sur les propriétés

currentIndex : QModelIndex [read-only]

Utilisez ` setCurrentIndex()` pour définir sa valeur.

Voir également setCurrentIndex() et currentChanged().

hasSelection : bool [read-only]

Cela déclenchera la mise à jour des liaisons de propriétés à chaque fois que selectionChanged() est émis, même si sa valeur n'a pas changé.

Voir également selection, selectedIndexes, select() et selectionChanged().

model : QAbstractItemModel

La valeur de cette propriété doit correspondre au modèle de la vue.

selectedIndexes : list<var> [read-only]

Contient la liste de tous les index (instances de `QModelIndex `) du modèle de sélection.

Voir également le type QModelIndexList.

selection : object [read-only]

Contient les plages de sélection enregistrées dans le modèle de sélection.

Documentation sur les signaux

currentChanged(QModelIndex current, QModelIndex previous)

Ce signal est émis chaque fois que l'élément actuel change. L'index de l'élément du modèle ` previous ` est remplacé par l'index ` current ` en tant qu'élément actuel de la sélection.

Notez que ce signal ne sera pas émis lorsque le modèle d’élément est réinitialisé.

Voir également currentIndex, setCurrentIndex() et selectionChanged().

selectionChanged(QItemSelection selected, QItemSelection deselected)

Ce signal est émis chaque fois que la sélection change. Le changement de sélection est représenté par une sélection d'éléments de type « deselected » et une sélection d'éléments de type « selected ».

Notez que l'index actuel change indépendamment de la sélection. Notez également que ce signal ne sera pas émis lorsque le modèle d'élément est réinitialisé.

Voir également select() et currentChanged().

Documentation de la méthode

void clear()

Efface le modèle de sélection. Émet les méthodes ` selectionChanged()` et ` currentChanged()`.

void clearCurrentIndex()

Efface l'index actuel. Émet la méthode ` currentChanged()`.

void clearSelection()

Efface la sélection dans le modèle de sélection. Émet la méthode ` selectionChanged()`.

bool columnIntersectsSelection(int column, QModelIndex parent)

Renvoie « true » s’il existe des éléments sélectionnés dans l’ column, dont l’ parent correspond à celle indiquée.

bool isColumnSelected(int column, QModelIndex parent)

Renvoie ` true ` si tous les éléments sont sélectionnés dans la ` column ` dont l'parent` est spécifiée.

Notez que cette fonction est généralement plus rapide que d’appeler isSelected() sur tous les éléments d’une même colonne, et que les éléments non sélectionnables sont ignorés.

bool isRowSelected(int row, QModelIndex parent)

Renvoie true si tous les éléments sont sélectionnés dans l'row, dont l'parent est donné.

Notez que cette fonction est généralement plus rapide que d’appeler isSelected() sur tous les éléments d’une même ligne, et que les éléments ne pouvant pas être sélectionnés sont ignorés.

bool isSelected(QModelIndex index)

Renvoie « true » si l'élément de modèle spécifié index est sélectionné.

void reset()

Efface le modèle de sélection. N'émet aucun signal.

bool rowIntersectsSelection(int row, QModelIndex parent)

Renvoie « true » s'il existe des éléments sélectionnés dans l'row avec l'parent spécifiée.

void select(QItemSelection selection, SelectionFlags command)

Sélectionne l'élément « selection » à l'aide de l'command spécifié, puis renvoie la fonction « selectionChanged() ».

Les valeurs valides de ` command ` sont décrites dans select(index, command).

void select(QModelIndex index, SelectionFlags command)

Sélectionne l'élément de modèle « index » à l'aide de l'command spécifié, puis renvoie « selectionChanged() ».

Les valeurs valides pour le paramètre ` command ` sont les suivantes :

list<var> selectedColumns(int row)

Renvoie les index (une liste d'instances de type ` QModelIndex `) dans l'row donné pour les colonnes dont toutes les lignes sont sélectionnées.

Voir également selectedRows() et le type QModelIndexList.

list<var> selectedRows(int column)

Renvoie les index (une liste d'instances de ` QModelIndex `) dans l'column on donnée pour les lignes dont toutes les colonnes sont sélectionnées.

Voir également selectedColumns() et le type QModelIndexList.

void setCurrentIndex(QModelIndex index, SelectionFlags command)

Définit l'élément « model item » index comme élément actif, puis déclenche l'événement currentChanged(). L'élément actif est utilisé pour la navigation au clavier et l'indication du focus ; il est indépendant des éléments sélectionnés, bien qu'un élément sélectionné puisse également être l'élément actif.

En fonction de l’ command spécifiée, l’ index peut également faire partie de la sélection actuelle.

Les valeurs valides de ` command ` sont décrites dans select(index, command).

Voir également select().