QItemSelectionRange Class
Die Klasse „QItemSelectionRange“ verwaltet Informationen zu einem Bereich ausgewählter Elemente in einem Modell. Mehr...
| Header: | #include <QItemSelectionRange> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Vergleiche mit QItemSelectionRange
| Kategorie | Vergleichbare Typen |
|---|---|
| Gleichheit | QItemSelectionRange |
Öffentliche Funktionen
| QItemSelectionRange() | |
| QItemSelectionRange(const QModelIndex &index) | |
| QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight) | |
| int | bottom() const |
| const QPersistentModelIndex & | bottomRight() const |
| bool | contains(const QModelIndex &index) const |
| bool | contains(int row, int column, const QModelIndex &parentIndex) const |
| int | height() const |
| QModelIndexList | indexes() const |
| QItemSelectionRange | intersected(const QItemSelectionRange &other) const |
| bool | intersects(const QItemSelectionRange &other) const |
| bool | isEmpty() const |
| bool | isValid() const |
| int | left() const |
| const QAbstractItemModel * | model() const |
| QModelIndex | parent() const |
| int | right() const |
| void | swap(QItemSelectionRange &other) |
| int | top() const |
| const QPersistentModelIndex & | topLeft() const |
| int | width() const |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
| bool | operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs) |
Ausführliche Beschreibung
Ein QItemSelectionRange enthält Informationen über einen Bereich ausgewählter Elemente in einem Modell. Ein Elementbereich ist ein zusammenhängendes Array von Modellelementen, das sich über mehrere benachbarte Zeilen und Spalten mit einem gemeinsamen übergeordneten Element erstreckt; dies lässt sich als zweidimensionaler Zellenblock in einer Tabelle veranschaulichen. Ein Auswahlbereich verfügt über eine „ top “ (), eine „ left “ (), eine „ bottom “ (), eine „ right “ () und eine „ parent “ ().
Die Klasse `QItemSelectionRange` gehört zu den Model/View-Klassen und ist Teil des Model/View-Frameworks von Qt.
Die im Auswahlbereich enthaltenen Modellelemente können mit der Funktion „ indexes()“ abgerufen werden. Verwenden Sie „ QItemSelectionModel::selectedIndexes()“, um eine Liste aller ausgewählten Elemente einer Ansicht zu erhalten.
Mit der Funktion ` contains()` können Sie feststellen, ob ein bestimmtes Modellelement innerhalb eines bestimmten Bereichs liegt. Bereiche können auch mithilfe der überladenen Operatoren für Gleichheit und Ungleichheit verglichen werden, und mit der Funktion ` intersects()` können Sie feststellen, ob sich zwei Bereiche überschneiden.
Siehe auch „Modell-/Ansichtsprogrammierung“, „ QAbstractItemModel “, „ QItemSelection “ und „ QItemSelectionModel “.
Dokumentation zu Mitgliedsfunktionen
[noexcept default] QItemSelectionRange::QItemSelectionRange()
Erstellt einen leeren Auswahlbereich.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Erstellt einen neuen Auswahlbereich, der ausschließlich das durch den Modellindex „ index “ angegebene Modellelement enthält.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Erstellt einen neuen Auswahlbereich, der ausschließlich den durch den Index „ topLeft “ und den Index „ bottomRight “ angegebenen Bereich enthält.
int QItemSelectionRange::bottom() const
Gibt den Zeilenindex zurück, der der untersten ausgewählten Zeile im Auswahlbereich entspricht.
const QPersistentModelIndex &QItemSelectionRange::bottomRight() const
Gibt den Index für das Element zurück, das sich in der rechten unteren Ecke des Auswahlbereichs befindet.
Siehe auch bottom(), right() und topLeft().
bool QItemSelectionRange::contains(const QModelIndex &index) const
Gibt „ true “ zurück, wenn das durch „ index “ angegebene Modellelement innerhalb des Bereichs der ausgewählten Elemente liegt; andernfalls wird „ false “ zurückgegeben.
bool QItemSelectionRange::contains(int row, int column, const QModelIndex &parentIndex) const
Gibt „ true “ zurück, wenn das durch (row, column) angegebene Modellelement mit „ parentIndex “ als übergeordnetem Element innerhalb des Bereichs der ausgewählten Elemente liegt; andernfalls wird „ false “ zurückgegeben.
Dies ist eine überladene Funktion.
int QItemSelectionRange::height() const
Gibt die Anzahl der ausgewählten Zeilen im Auswahlbereich zurück.
QModelIndexList QItemSelectionRange::indexes() const
Gibt die Liste der in der Auswahl gespeicherten Modellindexelemente zurück.
QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
Gibt einen neuen Auswahlbereich zurück, der nur die Elemente enthält, die sowohl im Auswahlbereich als auch im Auswahlbereich „ other “ vorkommen.
bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
Gibt „ true “ zurück, wenn sich dieser Auswahlbereich mit dem angegebenen Bereich „ other “ überschneidet; andernfalls wird „ false “ zurückgegeben.
bool QItemSelectionRange::isEmpty() const
Gibt „ true “ zurück, wenn der Auswahlbereich entweder keine Elemente enthält oder nur Elemente, die entweder deaktiviert oder als nicht auswählbar markiert sind.
bool QItemSelectionRange::isValid() const
Gibt „ true “ zurück, wenn der Auswahlbereich gültig ist; andernfalls wird „ false “ zurückgegeben.
int QItemSelectionRange::left() const
Gibt den Spaltenindex zurück, der der am weitesten links liegenden ausgewählten Spalte im Auswahlbereich entspricht.
const QAbstractItemModel *QItemSelectionRange::model() const
Gibt das Modell zurück, zu dem die Elemente im Auswahlbereich gehören.
QModelIndex QItemSelectionRange::parent() const
Gibt den Index des übergeordneten Modellelements der Elemente im Auswahlbereich zurück.
int QItemSelectionRange::right() const
Gibt den Spaltenindex zurück, der der am weitesten rechts liegenden ausgewählten Spalte im Auswahlbereich entspricht.
[noexcept] void QItemSelectionRange::swap(QItemSelectionRange &other)
Tauscht den Inhalt dieses Auswahlbereichs mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
int QItemSelectionRange::top() const
Gibt den Zeilenindex zurück, der der obersten ausgewählten Zeile im Auswahlbereich entspricht.
const QPersistentModelIndex &QItemSelectionRange::topLeft() const
Gibt den Index des Elements zurück, das sich in der oberen linken Ecke des Auswahlbereichs befindet.
Siehe auch top(), left() und bottomRight().
int QItemSelectionRange::width() const
Gibt die Anzahl der ausgewählten Spalten im Auswahlbereich zurück.
Verwandte Nicht-Mitglieder
[noexcept] bool operator!=(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Gibt „ true “ zurück, wenn sich der Auswahlbereich „ lhs “ vom angegebenen Bereich „ rhs “ unterscheidet; andernfalls wird „ false “ zurückgegeben.
[noexcept] bool operator==(const QItemSelectionRange &lhs, const QItemSelectionRange &rhs)
Gibt „ true “ zurück, wenn der Auswahlbereich „ lhs “ genau mit dem angegebenen Bereich „ rhs “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
© 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.
