ItemSelectionModel QML Type
Erstellt eine Instanz von ` QItemSelectionModel `, die in Verbindung mit einem ` QAbstractItemModel ` und einer beliebigen, dies unterstützenden Ansicht verwendet werden soll. 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)
Ausführliche Beschreibung
Siehe auch „ QItemSelectionModel “ und „Modelle und Ansichten“ unter Qt Quick.
Dokumentation zu Eigenschaften
currentIndex : QModelIndex [read-only]
Verwenden Sie setCurrentIndex(), um den Wert festzulegen.
Siehe auch setCurrentIndex() und currentChanged().
hasSelection : bool [read-only]
Jedes Mal, wenn selectionChanged() ausgelöst wird, werden Aktualisierungen der Eigenschaftsbindungen ausgelöst, 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 den Typ „QModelIndexList“.
selection : object [read-only]
Enthält die im Auswahlmodell gespeicherten Auswahlbereiche.
Signaldokumentation
currentChanged(QModelIndex current, QModelIndex previous)
Dieses Signal wird immer dann ausgelöst, wenn sich das aktuelle Element ändert. Der Index des Modells „ 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.
Hinweis: Der entsprechende Handler ist „ onCurrentChanged “.
Siehe auch „ currentIndex“ , „ setCurrentIndex()“ und „ selectionChanged()“.
selectionChanged(QItemSelection selected, 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 ausgelöst wird, wenn das Elementmodell zurückgesetzt wird.
Hinweis: Der entsprechende Handler ist onSelectionChanged.
Siehe auch „ select()“ und „ currentChanged()“.
Methodendokumentation
void clear()
Löscht das Auswahlmodell. Löst die Ereignisse „ selectionChanged()“ und „ currentChanged()“ aus.
void clearCurrentIndex()
Löscht den aktuellen Index. Löst „ currentChanged()“ aus.
void clearSelection()
Löscht die Auswahl im Auswahlmodell. Löst „ selectionChanged()“ aus.
bool columnIntersectsSelection(int column, QModelIndex parent)
Gibt „ true “ zurück, wenn im „ column “ Elemente mit dem angegebenen „ parent “ ausgewählt sind.
bool isColumnSelected(int column, QModelIndex parent)
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 derselben Spalte und dass nicht auswählbare Elemente ignoriert werden.
bool isRowSelected(int row, QModelIndex parent)
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.
bool isSelected(QModelIndex index)
Gibt „ true “ zurück, wenn das angegebene Modellelement „ index “ ausgewählt ist.
void reset()
Löscht das Auswahlmodell. Es werden keine Signale ausgegeben.
bool rowIntersectsSelection(int row, QModelIndex parent)
Gibt „ true “ zurück, wenn im „ row “ Elemente mit dem angegebenen „ parent “ ausgewählt sind.
void select(QItemSelection selection, SelectionFlags command)
Wählt das Element „ selection “ unter Verwendung des angegebenen „ command “ aus und gibt „ selectionChanged()“ zurück.
Gültige Werte für ` command ` sind beschrieben in select(index, command).
void select(QModelIndex index, SelectionFlags command)
Wählt das Modellelement „ index “ unter Verwendung des angegebenen „ command “ aus und gibt „ selectionChanged()“ aus.
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 Status ausgewählt oder die Auswahl wird aufgehoben. |
Current | Die aktuelle Auswahl wird aktualisiert. |
Rows | Alle Indizes werden so erweitert, dass sie sich über mehrere 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 bereitgestellt wird. |
ToggleCurrent | Eine Kombination aus „Umschalten“ und „Aktuell“, die der Einfachheit halber bereitgestellt wird. |
ClearAndSelect | Eine Kombination aus „Clear“ und „Select“, die der Einfachheit halber bereitgestellt wird. |
list<var> selectedColumns(int row)
Gibt die Indizes (eine Liste von „ QModelIndex “-Instanzen) in der angegebenen „ row “ für Spalten zurück, für die alle Zeilen ausgewählt sind.
Siehe auch ` selectedRows()` und den Typ `QModelIndexList`.
list<var> selectedRows(int column)
Gibt die Indizes (eine Liste von „ QModelIndex “-Instanzen) in der angegebenen „ column “ für die Zeilen zurück, in denen alle Spalten ausgewählt sind.
Siehe auch „ selectedColumns()“ und den Typ „QModelIndexList“.
void setCurrentIndex(QModelIndex index, 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 das „ index “ auch Teil der aktuellen Auswahl werden.
Gültige Werte für „ command “ sind beschrieben unter 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.