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]

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 [read-only]

Enthält die Liste aller Indizes im Auswahlmodell.


selection : object [read-only]

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().


bool columnIntersectsSelection(int column, QModelIndex parent)

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


bool isColumnSelected(int column, QModelIndex parent)

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.


bool isRowSelected(int row, QModelIndex parent)

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.


bool rowIntersectsSelection(int row, QModelIndex parent)

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:

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 aus- 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 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.