QItemSelectionRange Class
Die Klasse QItemSelectionRange verwaltet Informationen über einen Bereich von ausgewählten Elementen in einem Modell. Mehr...
| Kopfzeile: | #include <QItemSelectionRange> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Diese Klasse ist gleichwertig vergleichbar.
Ö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) |
Detaillierte Beschreibung
Ein QItemSelectionRange enthält Informationen über einen Bereich von ausgewählten Elementen in einem Modell. Ein Bereich von Elementen ist ein zusammenhängendes Array von Modellelementen, das sich über eine Anzahl von benachbarten Zeilen und Spalten mit einem gemeinsamen übergeordneten Element erstreckt; dies kann als zweidimensionaler Block von Zellen in einer Tabelle visualisiert werden. Ein Auswahlbereich hat ein top(), left() ein bottom(), right() und ein 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() ermittelt werden. Verwenden Sie QItemSelectionModel::selectedIndexes(), um eine Liste aller ausgewählten Elemente für eine Ansicht zu erhalten.
Sie können mit der Funktion contains() feststellen, ob ein bestimmtes Modellelement innerhalb eines bestimmten Bereichs liegt. Bereiche können auch mit den ü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 der Mitgliedsfunktionen
[noexcept] QItemSelectionRange::QItemSelectionRange()
Konstruiert einen leeren Auswahlbereich.
[explicit] QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
Konstruiert einen neuen Auswahlbereich, der nur das durch den Modellindex index angegebene Modellelement enthält.
QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Konstruiert einen neuen Auswahlbereich, der nur den durch topLeft angegebenen Index und den Index bottomRight 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
Liefert den Index für das Element, 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 der durch index angegebene Modelleintrag innerhalb des Bereichs der ausgewählten Einträge liegt; andernfalls wird false zurückgegeben.
bool QItemSelectionRange::contains(int row, int column, const QModelIndex &parentIndex) const
Dies ist eine überladene Funktion.
Gibt true zurück, wenn der durch (row, column) spezifizierte Modelleintrag mit parentIndex als übergeordnetem Eintrag innerhalb des Bereichs der ausgewählten Einträge liegt; andernfalls gibt sie false zurück.
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 enthalten sind.
bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
Gibt true zurück, wenn dieser Auswahlbereich den angegebenen Bereich other überschneidet (überlappt); andernfalls wird false zurückgegeben.
bool QItemSelectionRange::isEmpty() const
Gibt true zurück, wenn der Auswahlbereich entweder keine Elemente oder nur Elemente enthält, 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 nie 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 für das Element zurück, das sich in der linken oberen 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 von dem 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.
© 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.
