QItemSelectionModel Class

Dokumentation der Member-Funktionen

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

Erstellt ein Auswahlmodell, das auf dem angegebenen Element model angewendet wird.

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

Erstellt ein Auswahlmodell, das auf dem angegebenen Element model mit parent arbeitet.

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

Löscht das Auswahlmodell.

[virtual slot] void QItemSelectionModel::clear()

Löscht das Auswahlmodell. Sendet die Signale „ selectionChanged()“ und „ currentChanged()“.

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

Löscht den aktuellen Index. Löst die Ereignis currentChanged() aus.

[slot] void QItemSelectionModel::clearSelection()

Löscht die Auswahl im Auswahlmodell. Löst „ selectionChanged()“ aus.

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

Gibt ` true ` zurück, wenn im ` column ` Elemente mit dem angegebenen ` parent` ausgewählt sind.

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

Dieses Signal wird immer dann ausgelöst, wenn sich das aktuelle Element ändert. Der Index des Elementmodells „ previous “ wird durch den Index „ current “ als aktuelles Element der Auswahl ersetzt.

Beachten Sie, dass dieses Signal nicht ausgelöst wird, wenn das Elementmodell zurückgesetzt wird.

Siehe auch currentIndex(), setCurrentIndex() und selectionChanged().

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

Dieses Signal wird ausgelöst, wenn sich das Element „ current “ ändert und dessen Spalte sich von der Spalte des aktuellen Elements „ previous “ unterscheidet.

Beachten Sie, dass dieses Signal nicht ausgelöst wird, wenn das Elementmodell zurückgesetzt wird.

Siehe auch „ currentChanged()“, „ currentRowChanged()“, „ currentIndex()“ und „ setCurrentIndex()“.

QModelIndex QItemSelectionModel::currentIndex() const

Gibt den Modellelementindex für das aktuelle Element zurück oder einen ungültigen Index, wenn kein aktuelles Element vorhanden ist.

Siehe auch ` setCurrentIndex()`.

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

Dieses Signal wird ausgelöst, wenn sich das Element „ current “ ändert und seine Zeile sich von der Zeile des aktuellen Elements „ previous “ unterscheidet.

Beachten Sie, dass dieses Signal nicht ausgelöst wird, wenn das Elementmodell zurückgesetzt wird.

Siehe auch „ currentChanged()“, „ currentColumnChanged()“, „ currentIndex()“ und „ setCurrentIndex()“.

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

Vergleicht die beiden Auswahlen newSelection und oldSelection und gibt selectionChanged() mit den abgewählten und ausgewählten Elementen zurück.

bool QItemSelectionModel::hasSelection() const

Gibt „ true “ zurück, wenn das Auswahlmodell ein ausgewähltes Element enthält; andernfalls wird „ false “ zurückgegeben.

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

Gibt „ true “ zurück, wenn alle Elemente in der „ column “ mit dem angegebenen „ parent “ ausgewählt sind.

Beachten Sie, dass diese Funktion in der Regel schneller ist als der Aufruf von ` isSelected()` für alle Elemente in derselben Spalte und dass nicht auswählbare Elemente ignoriert werden.

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

Gibt „ true “ zurück, wenn alle Elemente in der „ row “ mit dem angegebenen „ parent “ ausgewählt sind.

Beachten Sie, dass diese Funktion in der Regel schneller ist als der Aufruf von ` isSelected()` für alle Elemente in derselben Zeile und dass nicht auswählbare Elemente ignoriert werden.

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

Gibt „ true “ zurück, wenn das angegebene Modellelement „ index “ ausgewählt ist.

QAbstractItemModel *QItemSelectionModel::model()

Gibt das Elementmodell zurück, auf das das Auswahlmodell angewendet wurde.

Siehe auch „ setModel()“.

const QAbstractItemModel *QItemSelectionModel::model() const

Gibt das Elementmodell zurück, auf das das Auswahlmodell angewendet wurde.

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

Dieses Signal wird ausgelöst, wenn die „ model “ erfolgreich mit „ setModel()“ gesetzt wurde.

Siehe auch „ model()“ und „ setModel()“.

[virtual slot] void QItemSelectionModel::reset()

Löscht das Auswahlmodell. Es werden keine Signale ausgegeben.

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

Gibt „ true “ zurück, wenn im „ row “ Elemente mit dem angegebenen „ parent “ ausgewählt sind.

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

Wählt das Element „ selection “ unter Verwendung des angegebenen „ command “ aus und gibt „ selectionChanged()“ aus.

// 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); });

Siehe auch „ QItemSelectionModel::SelectionFlag “.

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

Wählt das Modellobjekt „ index “ unter Verwendung des angegebenen „ command “ aus und gibt „ selectionChanged()“ aus.

// 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); });

Siehe auch „ QItemSelectionModel::SelectionFlags “.

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

Gibt die Indizes im angegebenen „ row “ für Spalten zurück, bei denen alle Zeilen ausgewählt sind.

Siehe auch ` selectedIndexes()` und ` selectedRows()`.

QModelIndexList QItemSelectionModel::selectedIndexes() const

Gibt eine Liste aller ausgewählten Modellelement-Indizes zurück. Die Liste enthält keine Duplikate und ist nicht sortiert.

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

Gibt die Indizes im angegebenen „ column “ für die Zeilen zurück, bei denen alle Spalten ausgewählt sind.

Siehe auch ` selectedIndexes()` und ` selectedColumns()`.

const QItemSelection QItemSelectionModel::selection() const

Gibt die im Auswahlmodell gespeicherten Auswahlbereiche zurück.

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

Dieses Signal wird immer dann ausgelöst, wenn sich die Auswahl ändert. Die Änderung der Auswahl wird als Elementauswahl der Elemente „ deselected “ und als Elementauswahl der Elemente „ selected “ dargestellt.

Beachten Sie, dass sich der aktuelle Index unabhängig von der Auswahl ändert. Beachten Sie außerdem, dass dieses Signal nicht ausgesendet wird, wenn das Elementmodell zurückgesetzt wird.

Elemente, die ausgewählt bleiben, aber ihren Index ändern, werden nicht in „ selected “ und „ deselected “ berücksichtigt. Daher kann dieses Signal auch dann ausgelöst werden, wenn sowohl „ selected “ als auch „ deselected “ leer sind, sofern sich lediglich die Indizes der ausgewählten Elemente ändern.

Siehe auch „ select()“ und „ currentChanged()“.

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

Setzt das Modellelement „ index “ als aktuelles Element und löst „ currentChanged()“ aus. Das aktuelle Element wird für die Tastaturnavigation und die Fokusanzeige verwendet; es ist unabhängig von ausgewählten Elementen, obwohl ein ausgewähltes Element auch das aktuelle Element sein kann.

Je nach dem angegebenen „ command “ kann der „ index “ auch Teil der aktuellen Auswahl werden.

Siehe auch ` currentIndex()` und ` select()`.

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Setzt das Modell auf „ model “. Das Signal „ modelChanged()“ wird ausgegeben.

Siehe auch „ model()“ und „ modelChanged()“.