Auf dieser Seite

ItemSelectionModel QML Type

Instanziiert eine QItemSelectionModel, die in Verbindung mit einer QAbstractItemModel und jeder sie unterstützenden Ansicht verwendet werden kann. Mehr...

Import Statement: import QtQml.Models
In C++: QItemSelectionModel

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Siehe auch QItemSelectionModel und Modelle und Ansichten in Qt Quick.

Dokumentation der Eigenschaft

currentIndex : QModelIndex [read-only]

Verwenden Sie setCurrentIndex(), um seinen Wert zu setzen.

Siehe auch setCurrentIndex() und currentChanged().

hasSelection : bool [read-only]

Es löst jedes Mal eine Aktualisierung der Eigenschaftsbindung aus, wenn selectionChanged() ausgegeben wird, auch wenn sich der Wert nicht geändert hat.

Siehe auch selection, selectedIndexes, select(), und selectionChanged().

model : QAbstractItemModel

Der Wert dieser Eigenschaft muss mit dem Modell der Ansicht übereinstimmen.

selectedIndexes : list<var> [read-only]

Enthält die Liste aller Indizes (QModelIndex Instanzen) im Auswahlmodell.

Siehe auch QModelIndexList Typ.

selection : object [read-only]

Enthält die im Auswahlmodell gespeicherten Auswahlbereiche.

Signal Dokumentation

currentChanged(QModelIndex current, QModelIndex previous)

Dieses Signal wird ausgegeben, wenn sich das aktuelle Element ändert. Der Artikelindex des Modells previous wird durch den Index current als aktueller Artikel der Auswahl ersetzt.

Beachten Sie, dass dieses Signal nicht ausgegeben wird, wenn das Elementmodell zurückgesetzt wird.

Hinweis: Der entsprechende Handler ist onCurrentChanged.

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

selectionChanged(QItemSelection selected, QItemSelection deselected)

Dieses Signal wird ausgegeben, wenn sich die Auswahl ändert. Die Änderung der Auswahl wird als eine Auswahl von deselected Elementen und eine Auswahl von selected Elementen dargestellt.

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

Hinweis: Der entsprechende Handler ist onSelectionChanged.

Siehe auch select() und currentChanged().

Dokumentation der Methode

void clear()

Löscht das Auswahlmodell. Gibt selectionChanged() und currentChanged() aus.

void clearCurrentIndex()

Löscht den aktuellen Index. Gibt currentChanged() aus.

void clearSelection()

Löscht die Auswahl im Auswahlmodell. Gibt selectionChanged() aus.

bool columnIntersectsSelection(int column, QModelIndex parent)

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

bool isColumnSelected(int column, QModelIndex parent)

Gibt true zurück, wenn alle Einträge 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.

bool isRowSelected(int row, QModelIndex parent)

Gibt true zurück, wenn alle Einträge 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 Einträge in derselben Zeile und dass nicht auswählbare Einträge ignoriert werden.

bool isSelected(QModelIndex index)

Gibt true zurück, wenn der angegebene Modellartikel index ausgewählt ist.

void reset()

Löscht das Auswahlmodell. Gibt keine Signale aus.

bool rowIntersectsSelection(int row, QModelIndex parent)

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

void select(QItemSelection selection, SelectionFlags command)

Wählt den Eintrag selection unter Verwendung des angegebenen command aus und sendet selectionChanged().

Gültige Werte für command sind beschrieben in select(index, command).

void select(QModelIndex index, SelectionFlags command)

Wählt die Modellposition index unter Verwendung des angegebenen command aus und sendet selectionChanged().

Gültige Werte für den Parameter command, sind:

KonstanteBeschreibung
NoUpdateEs wird keine Auswahl getroffen.
ClearDie gesamte Auswahl wird gelöscht.
SelectAlle angegebenen Indizes werden ausgewählt.
DeselectAlle angegebenen Indizes werden abgewählt.
ToggleAlle angegebenen Indizes werden je nach ihrem aktuellen Zustand ausgewählt oder abgewählt.
CurrentDie aktuelle Auswahl wird aktualisiert.
RowsAlle Indizes werden so erweitert, dass sie sich über Zeilen erstrecken.
ColumnsAlle Indizes werden so erweitert, dass sie sich über Spalten erstrecken.
SelectCurrentEine Kombination aus Auswählen und Aktuell, die der Einfachheit halber angeboten wird.
ToggleCurrentEine Kombination aus Umschalten und Aktuell, die der Einfachheit halber angeboten wird.
ClearAndSelectEine Kombination aus Löschen und Auswählen, die der Einfachheit halber angeboten wird.

list<var> selectedColumns(int row)

Liefert die Indizes (eine Liste von QModelIndex Instanzen) in der angegebenen row für Spalten, in denen alle Zeilen ausgewählt sind.

Siehe auch selectedRows() und QModelIndexList Type.

list<var> selectedRows(int column)

Liefert die Indizes (eine Liste von QModelIndex -Instanzen) in der angegebenen column für die Zeilen, in denen alle Spalten ausgewählt sind.

Siehe auch selectedColumns() und QModelIndexList Type.

void setCurrentIndex(QModelIndex index, SelectionFlags command)

Legt das Modellelement index als das aktuelle Element fest und gibt currentChanged() aus. Das aktuelle Element wird für die Tastaturnavigation und die Anzeige des Fokus verwendet; es ist unabhängig von ausgewählten Elementen, obwohl ein ausgewähltes Element auch das aktuelle Element sein kann.

Abhängig von der Angabe command kann index auch Teil der aktuellen Auswahl werden.

Gültige Werte für command sind beschrieben in select(index, command).

Siehe auch 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.