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
- currentIndex : QModelIndex
- hasSelection : bool
- model : QAbstractItemModel
- selectedIndexes : list<var>
- selection : object
Signale
- currentChanged(QModelIndex current, QModelIndex previous)
- selectionChanged(QItemSelection selected, QItemSelection deselected)
Methoden
- 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)
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:
| Konstante | Beschreibung |
|---|---|
NoUpdate | Es wird keine Auswahl getroffen. |
Clear | Die gesamte Auswahl wird gelöscht. |
Select | Alle angegebenen Indizes werden ausgewählt. |
Deselect | Alle angegebenen Indizes werden abgewählt. |
Toggle | Alle angegebenen Indizes werden je nach ihrem aktuellen Zustand ausgewählt oder abgewählt. |
Current | Die aktuelle Auswahl wird aktualisiert. |
Rows | Alle Indizes werden so erweitert, dass sie sich über Zeilen erstrecken. |
Columns | Alle Indizes werden so erweitert, dass sie sich über Spalten erstrecken. |
SelectCurrent | Eine Kombination aus Auswählen und Aktuell, die der Einfachheit halber angeboten wird. |
ToggleCurrent | Eine Kombination aus Umschalten und Aktuell, die der Einfachheit halber angeboten wird. |
ClearAndSelect | Eine 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.