QItemSelectionModel Class

Documentation des fonctions membres

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

Crée un modèle de sélection qui s'applique à l'model s de l'élément spécifié.

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

Construit un modèle de sélection qui s'applique à l'model s de l'élément spécifié à l'aide de parent.

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

Supprime le modèle de sélection.

[virtual slot] void QItemSelectionModel::clear()

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

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

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

[slot] void QItemSelectionModel::clearSelection()

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

[invokable] bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const

Renvoie ` true ` s'il existe des éléments sélectionnés dans l'column, dont l'parent correspond à celui fourni.

[signal] void QItemSelectionModel::currentChanged(const QModelIndex &current, const 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().

[signal] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

Ce signal est émis si l'élément « current » change et que sa colonne diffère de celle de l'élément actuel de « previous ».

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

Voir également currentChanged(), currentRowChanged(), currentIndex() et setCurrentIndex().

QModelIndex QItemSelectionModel::currentIndex() const

Renvoie l'index de l'élément du modèle correspondant à l'élément actuel, ou un index non valide s'il n'y a pas d'élément actuel.

Voir également setCurrentIndex().

[signal] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

Ce signal est émis si l'élément « current » change et que sa ligne diffère de celle de l'élément actuel de « previous ».

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

Voir également currentChanged(), currentColumnChanged(), currentIndex() et setCurrentIndex().

[protected] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

Compare les deux sélections newSelection et oldSelection, puis affiche selectionChanged() avec les éléments désélectionnés et sélectionnés.

bool QItemSelectionModel::hasSelection() const

Renvoie « true » si le modèle de sélection contient au moins un élément sélectionné ; sinon, renvoie « false ».

[invokable] bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const

Renvoie true si tous les éléments sont sélectionnés dans l'column, avec l'parent indiqué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.

[invokable] bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const

Renvoie ` true ` si tous les éléments sont sélectionnés dans l'row, avec l'parent` indiquée.

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 non sélectionnables sont ignorés.

[invokable] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

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

QAbstractItemModel *QItemSelectionModel::model()

Renvoie le modèle d'élément sur lequel porte le modèle de sélection.

Voir également setModel().

const QAbstractItemModel *QItemSelectionModel::model() const

Renvoie le modèle d'élément sur lequel porte le modèle de sélection.

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

Ce signal est émis lorsque la fonction « model » a été définie avec succès à l'aide de la fonction « setModel() ».

Voir également model() et setModel().

[virtual slot] void QItemSelectionModel::reset()

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

[invokable] bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const

Renvoie ` true ` s'il existe des éléments sélectionnés dans l'row, dont l'parent correspond à celui fourni.

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

Sélectionne l'élément selection à l'aide de l'command spécifié, puis émet selectionChanged().

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) { receiver->select(selection, command); });

Voir également QItemSelectionModel::SelectionFlag.

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QModelIndex &index, QItemSelectionModel::SelectionFlags command) { receiver->select(index, command); });

Voir également QItemSelectionModel::SelectionFlags.

[invokable] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

Renvoie les indices, dans l'row on fournie, des colonnes pour lesquelles toutes les lignes sont sélectionnées.

Voir également ` selectedIndexes()` et ` selectedRows()`.

QModelIndexList QItemSelectionModel::selectedIndexes() const

Renvoie une liste de tous les index des éléments du modèle sélectionnés. La liste ne contient pas de doublons et n'est pas triée.

[invokable] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

Renvoie les index de l'column on donnée correspondant aux lignes dont toutes les colonnes sont sélectionnées.

Voir également ` selectedIndexes()` et ` selectedColumns()`.

const QItemSelection QItemSelectionModel::selection() const

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

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const 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 n’est pas émis lorsque le modèle d’éléments est réinitialisé.

Les éléments qui restent sélectionnés mais dont l’index change ne sont pas inclus dans selected et deselected. Ainsi, ce signal peut être émis alors que selected et deselected sont vides, si seuls les indices des éléments sélectionnés changent.

Voir également select() et currentChanged().

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Définit l'élément « index » du modèle 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.

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

Voir également currentIndex() et select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Définit le modèle sur « model ». Le signal « modelChanged() » sera émis.

Voir également model() et modelChanged().