Auf dieser Seite

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

Signale

Methoden

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:

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 Status ausgewählt oder die Auswahl wird aufgehoben.
CurrentDie aktuelle Auswahl wird aktualisiert.
RowsAlle Indizes werden so erweitert, dass sie sich über mehrere Zeilen erstrecken.
ColumnsAlle Indizes werden so erweitert, dass sie sich über Spalten erstrecken.
SelectCurrentEine Kombination aus „Auswählen“ und „Aktuell“, die der Einfachheit halber bereitgestellt wird.
ToggleCurrentEine Kombination aus „Umschalten“ und „Aktuell“, die der Einfachheit halber bereitgestellt wird.
ClearAndSelectEine 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.