QItemSelectionModel Class

Fonction membre Documentation

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

Construit un modèle de sélection qui opère sur l'élément spécifié model.

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

Construit un modèle de sélection qui opère sur l'élément spécifié model avec parent.

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

Détruit le modèle de sélection.

[virtual slot] void QItemSelectionModel::clear()

Efface le modèle de sélection. Emet selectionChanged() et currentChanged().

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

Efface l'index actuel. Emet currentChanged().

[slot] void QItemSelectionModel::clearSelection()

Efface la sélection dans le modèle de sélection. Emet selectionChanged().

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

Renvoie true s'il y a des éléments sélectionnés dans column avec parent.

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

Ce signal est émis lorsque l'élément courant change. L'index de l'élément du modèle previous est remplacé par l'index current en tant qu'élément courant de la sélection.

Notez que ce signal n'est 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 est différente de celle de l'élément courant previous.

Notez que ce signal n'est pas émis lorsque le modèle d'élément est réinitialisé.

Voir aussi currentChanged(), currentRowChanged(), currentIndex() et setCurrentIndex().

QModelIndex QItemSelectionModel::currentIndex() const

Renvoie l'index de l'élément de modèle pour l'élément courant, ou un index invalide s'il n'y a pas d'élément courant.

Voir aussi 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 est différente de celle de l'élément courant previous.

Notez que ce signal n'est pas émis lorsque le modèle d'élément est réinitialisé.

Voir aussi currentChanged(), currentColumnChanged(), currentIndex() et setCurrentIndex().

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

Compare les deux sélections newSelection et oldSelection et émet 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 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 la colonne column avec la valeur parent.

Notez que cette fonction est généralement plus rapide que d'appeler isSelected() sur tous les éléments de la 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 row avec parent.

Notez que cette fonction est généralement plus rapide que d'appeler isSelected() sur tous les éléments de la 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 exploité par le modèle de sélection.

Voir aussi setModel().

const QAbstractItemModel *QItemSelectionModel::model() const

Renvoie le modèle d'élément exploité par le modèle de sélection.

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

Ce signal est émis lorsque l'adresse model est définie avec succès à l'aide de setModel().

Voir aussi 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 y a des éléments sélectionnés dans row avec parent.

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

Sélectionne l'élément selection à l'aide de l'élément spécifié command, et é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 aussi QItemSelectionModel::SelectionFlag.

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

Sélectionne l'élément du modèle index à l'aide de l'élément spécifié command, et é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 aussi QItemSelectionModel::SelectionFlags.

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

Renvoie les index dans le site row pour les colonnes où toutes les lignes sont sélectionnées.

Voir également selectedIndexes() et selectedRows().

QModelIndexList QItemSelectionModel::selectedIndexes() const

Renvoie une liste de tous les index d'éléments de 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 dans le site column pour les 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 stockées dans le modèle de sélection.

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Ce signal est émis lorsque la sélection change. La modification de la sélection est représentée par une sélection d'éléments de deselected et une sélection d'éléments de selected.

Notez que l'indice 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é.

Les éléments qui restent sélectionnés mais dont l'indice change ne sont pas inclus dans selected et deselected. Ainsi, ce signal peut être émis lorsque 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 de modèle index comme étant l'élément courant et émet currentChanged(). L'élément courant est utilisé pour la navigation au clavier et l'indication du focus ; il est indépendant de tout élément sélectionné, bien qu'un élément sélectionné puisse également être l'élément courant.

En fonction de l'adresse command spécifiée, l'adresse index peut également faire partie de la sélection en cours.

Voir également currentIndex() et select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Définit le modèle à model. Le signal modelChanged() sera émis.

Voir aussi model() et modelChanged().