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 : QModelIndexList
- 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)
- QModelIndexList selectedColumns(int row)
- QModelIndexList 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 |
Verwenden Sie setCurrentIndex(), um seinen Wert zu setzen.
Siehe auch setCurrentIndex() und currentChanged().
hasSelection : bool |
Sie löst bei jeder Ausgabe von selectionChanged() eine Aktualisierung der Eigenschaftsbindung aus, auch wenn sich ihr 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 : QModelIndexList |
Enthält die Liste aller Indizes im Auswahlmodell.
selection : object |
Enthält die Auswahlbereiche, die im Auswahlmodell gespeichert sind.
Signal Dokumentation
currentChanged(QModelIndex current, QModelIndex previous) |
Dieses Signal wird ausgegeben, wenn sich das aktuelle Element ändert. Der Index des Modells previous wird durch den Index current als das aktuelle Element 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 Elementauswahl von deselected und eine Elementauswahl von selected 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. Sendet selectionChanged() und currentChanged().
void clearCurrentIndex() |
Löscht den aktuellen Index. Gibt currentChanged() aus.
void clearSelection() |
Löscht die Auswahl im Auswahlmodell. Sendet selectionChanged().
Gibt true
zurück, wenn in column mit dem angegebenen parent Elemente ausgewählt sind.
Gibt true
zurück, wenn alle Elemente im 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 Einträge in derselben Spalte und dass nicht auswählbare Einträge ignoriert werden.
Gibt true
zurück, wenn alle Elemente in 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.
bool isSelected(QModelIndex index) |
Gibt true
zurück, wenn das angegebene Modellelement index ausgewählt ist.
void reset() |
Löscht das Auswahlmodell. Gibt keine Signale aus.
Gibt true
zurück, wenn im row mit dem angegebenen parent irgendwelche Elemente ausgewählt sind.
void select(QItemSelection selection, SelectionFlags command) |
Wählt das Element selection mit dem angegebenen command aus und sendet selectionChanged().
Gültige command Werte sind beschrieben in select(index, command).
void select(QModelIndex index, SelectionFlags command) |
Wählt das Modellelement 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 aus- 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 Clear und Select, die der Einfachheit halber bereitgestellt wird. |
QModelIndexList selectedColumns(int row) |
Gibt die Indizes in der angegebenen row für Spalten zurück, in denen alle Zeilen ausgewählt sind.
Siehe auch selectedRows().
QModelIndexList selectedRows(int column) |
Gibt die Indizes in der angegebenen column für die Zeilen zurück, in denen alle Spalten ausgewählt sind.
Siehe auch selectedColumns().
void setCurrentIndex(QModelIndex index, SelectionFlags command) |
Setzt das Modellelement index auf das aktuelle Element 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().
© 2025 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.