QHeaderView Class

treeView->setRootIsDecorated(false);
treeView->header()->setFirstSectionMovable(true);

Dokumentation der Mitgliedsfunktionen

[explicit] QHeaderView::QHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)

Erzeugt einen neuen generischen Header mit dem angegebenen orientation und parent.

[virtual noexcept] QHeaderView::~QHeaderView()

Zerstört die Kopfzeile.

int QHeaderView::count() const

Gibt die Anzahl der Abschnitte in der Kopfzeile zurück.

Siehe auch sectionCountChanged() und length().

[override virtual protected] void QHeaderView::currentChanged(const QModelIndex &current, const QModelIndex &old)

Reimplements: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

[override virtual protected] bool QHeaderView::event(QEvent *e)

Reimplements: QAbstractItemView::event(QEvent *Event).

[signal] void QHeaderView::geometriesChanged()

Dieses Signal wird ausgegeben, wenn sich die Geometrien des Kopfes geändert haben.

[slot] void QHeaderView::headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast)

Aktualisiert die geänderten Kopfabschnitte mit dem angegebenen orientation, von logicalFirst bis einschließlich logicalLast.

int QHeaderView::hiddenSectionCount() const

Gibt die Anzahl der Abschnitte in der Kopfzeile zurück, die ausgeblendet wurden.

Siehe auch setSectionHidden() und isSectionHidden().

void QHeaderView::hideSection(int logicalIndex)

Blendet den durch logicalIndex angegebenen Abschnitt aus.

Siehe auch showSection(), isSectionHidden(), hiddenSectionCount(), und setSectionHidden().

[override virtual protected] int QHeaderView::horizontalOffset() const

Reimplements: QAbstractItemView::horizontalOffset() const.

Gibt den horizontalen Versatz der Kopfzeile zurück. Für vertikale Kopfzeilen ist dieser Wert 0.

Siehe auch offset().

[virtual protected] void QHeaderView::initStyleOption(QStyleOptionHeader *option) const

Initialisieren Sie option mit den Werten aus dieser QHeaderView. Diese Methode ist für Unterklassen nützlich, wenn sie eine QStyleOptionHeader benötigen, aber nicht alle Informationen selbst ausfüllen wollen.

Siehe auch QStyleOption::initFrom() und initStyleOptionForIndex().

[virtual protected, since 6.0] void QHeaderView::initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const

Initialisiert den Stil option aus dem angegebenen logicalIndex. Diese Funktion wird von der Standardimplementierung von paintSection aufgerufen, nachdem initStyleOption aufgerufen wurde.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch paintSection() und initStyleOption().

bool QHeaderView::isSectionHidden(int logicalIndex) const

Gibt true zurück, wenn der durch logicalIndex angegebene Abschnitt ausdrücklich vor dem Benutzer verborgen ist; andernfalls wird false zurückgegeben.

Siehe auch hideSection(), showSection(), setSectionHidden(), und hiddenSectionCount().

int QHeaderView::length() const

Gibt die Länge entlang der Ausrichtung der Kopfzeile zurück.

Siehe auch sizeHint(), setSectionResizeMode(), und offset().

int QHeaderView::logicalIndex(int visualIndex) const

Gibt den logicalIndex für den Abschnitt an der angegebenen Position visualIndex zurück, oder -1, wenn visualIndex < 0 oder visualIndex >= QHeaderView::count().

Beachten Sie, dass visualIndex nicht von versteckten Abschnitten beeinflusst wird.

Siehe auch visualIndex() und sectionPosition().

int QHeaderView::logicalIndexAt(const QPoint &pos) const

Gibt den logischen Index des Abschnitts an der in pos angegebenen Position zurück. Wenn die Kopfzeile horizontal ist, wird die x-Koordinate verwendet, andernfalls die y-Koordinate, um den logischen Index zu finden.

Siehe auch sectionPosition().

int QHeaderView::logicalIndexAt(int position) const

Gibt den Abschnitt zurück, der die angegebene position im Ansichtsfenster abdeckt.

Siehe auch visualIndexAt() und isSectionHidden().

int QHeaderView::logicalIndexAt(int x, int y) const

Gibt den logischen Index des Abschnitts an der angegebenen Koordinate zurück. Wenn die Kopfzeile horizontal ist, wird x verwendet, andernfalls wird y verwendet, um den logischen Index zu finden.

[override virtual protected] void QHeaderView::mouseDoubleClickEvent(QMouseEvent *e)

Reimplements: QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QHeaderView::mouseMoveEvent(QMouseEvent *e)

Reimplements: QAbstractItemView::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QHeaderView::mousePressEvent(QMouseEvent *e)

Reimplements: QAbstractItemView::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QHeaderView::mouseReleaseEvent(QMouseEvent *e)

Reimplements: QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

void QHeaderView::moveSection(int from, int to)

Verschiebt den Abschnitt mit dem visuellen Index from auf den visuellen Index to.

Siehe auch sectionsMoved().

int QHeaderView::offset() const

Gibt den Versatz der Kopfzeile zurück: Dies ist der äußerste linke (oder oberste bei vertikalen Kopfzeilen) sichtbare Pixel der Kopfzeile.

Siehe auch setOffset().

Qt::Orientation QHeaderView::orientation() const

Gibt die Ausrichtung der Kopfzeile zurück.

Siehe auch Qt::Orientation.

[override virtual protected] void QHeaderView::paintEvent(QPaintEvent *e)

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

[virtual protected] void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const

Zeichnet den durch die angegebene logicalIndex angegebenen Bereich unter Verwendung der angegebenen painter und rect.

Normalerweise müssen Sie diese Funktion nicht aufrufen.

[override virtual] void QHeaderView::reset()

Reimplements: QAbstractItemView::reset().

int QHeaderView::resizeContentsPrecision() const

Gibt zurück, wie genau QHeaderView auf ResizeToContents berechnet.

Siehe auch setResizeContentsPrecision() und setSectionResizeMode().

void QHeaderView::resizeSection(int logicalIndex, int size)

Ändert die Größe des durch logicalIndex angegebenen Abschnitts auf size, gemessen in Pixeln. Der Parameter size muss ein Wert größer oder gleich Null sein. Eine Größe gleich Null ist jedoch nicht empfehlenswert. In diesem Fall sollte stattdessen hideSection verwendet werden.

Siehe auch sectionResized(), sectionSize(), und hideSection().

[protected slot] void QHeaderView::resizeSections()

Ändert die Größe der Abschnitte entsprechend den Größenhinweisen. Normalerweise müssen Sie diese Funktion nicht aufrufen.

void QHeaderView::resizeSections(QHeaderView::ResizeMode mode)

Ändert die Größe der Abschnitte entsprechend der angegebenen mode. Dabei wird der aktuelle Größenänderungsmodus ignoriert.

Siehe auch sectionResized().

bool QHeaderView::restoreState(const QByteArray &state)

Stellt die state dieser Kopfansicht wieder her. Diese Funktion gibt true zurück, wenn der Zustand wiederhergestellt wurde; andernfalls wird false zurückgegeben.

Siehe auch saveState().

QByteArray QHeaderView::saveState() const

Speichert den aktuellen Zustand dieser Kopfzeilenansicht.

Um den gespeicherten Zustand wiederherzustellen, übergeben Sie den Rückgabewert an restoreState().

Siehe auch restoreState().

[signal] void QHeaderView::sectionClicked(int logicalIndex)

Dieses Signal wird ausgegeben, wenn ein Abschnitt angeklickt wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben.

Beachten Sie, dass auch das Signal sectionPressed ausgegeben wird.

Siehe auch setSectionsClickable() und sectionPressed().

[signal] void QHeaderView::sectionCountChanged(int oldCount, int newCount)

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Abschnitte ändert, d. h. wenn Abschnitte hinzugefügt oder gelöscht werden. Die ursprüngliche Anzahl wird durch oldCount angegeben, die neue Anzahl durch newCount.

Siehe auch count(), length(), und headerDataChanged().

[signal] void QHeaderView::sectionDoubleClicked(int logicalIndex)

Dieses Signal wird ausgegeben, wenn ein Abschnitt doppelt angeklickt wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben.

Siehe auch setSectionsClickable().

[signal] void QHeaderView::sectionEntered(int logicalIndex)

Dieses Signal wird ausgegeben, wenn sich der Cursor über dem Abschnitt befindet und die linke Maustaste gedrückt wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben.

Siehe auch setSectionsClickable() und sectionPressed().

[signal] void QHeaderView::sectionHandleDoubleClicked(int logicalIndex)

Dieses Signal wird ausgegeben, wenn ein Abschnitt doppelt angeklickt wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben.

Siehe auch setSectionsClickable().

[signal] void QHeaderView::sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex)

Dieses Signal wird ausgesendet, wenn ein Abschnitt verschoben wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben, der alte Index durch oldVisualIndex und die neue Indexposition durch newVisualIndex.

Siehe auch moveSection().

int QHeaderView::sectionPosition(int logicalIndex) const

Gibt die Position des Abschnitts des angegebenen logicalIndex zurück, oder -1, wenn der Abschnitt ausgeblendet ist. Die Position wird in Pixeln von der oberen linken Ecke des ersten sichtbaren Elements bis zur oberen linken Ecke des Elements mit logicalIndex gemessen. Die Messung erfolgt entlang der x-Achse für horizontale Kopfzeilen und entlang der y-Achse für vertikale Kopfzeilen.

Siehe auch sectionViewportPosition().

[signal] void QHeaderView::sectionPressed(int logicalIndex)

Dieses Signal wird ausgegeben, wenn ein Abschnitt gedrückt wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben.

Siehe auch setSectionsClickable().

QHeaderView::ResizeMode QHeaderView::sectionResizeMode(int logicalIndex) const

Gibt den Größenänderungsmodus zurück, der für den durch die angegebene logicalIndex angegebenen Abschnitt gilt.

Siehe auch setSectionResizeMode().

[signal] void QHeaderView::sectionResized(int logicalIndex, int oldSize, int newSize)

Dieses Signal wird ausgegeben, wenn die Größe eines Abschnitts geändert wird. Die logische Nummer des Abschnitts wird durch logicalIndex angegeben, die alte Größe durch oldSize und die neue Größe durch newSize.

Siehe auch resizeSection().

int QHeaderView::sectionSize(int logicalIndex) const

Gibt die Breite (oder Höhe für vertikale Kopfzeilen) der angegebenen logicalIndex zurück.

Siehe auch length(), setSectionResizeMode(), und defaultSectionSize().

[virtual protected] QSize QHeaderView::sectionSizeFromContents(int logicalIndex) const

Gibt die Größe des Inhalts des Abschnitts zurück, der durch den angegebenen logicalIndex angegeben wird.

Siehe auch defaultSectionSize().

int QHeaderView::sectionSizeHint(int logicalIndex) const

Gibt einen geeigneten Größenhinweis für den durch logicalIndex angegebenen Abschnitt zurück.

Qt::SizeHintRole

Siehe auch sizeHint(), defaultSectionSize(), minimumSectionSize(), und maximumSectionSize().

int QHeaderView::sectionViewportPosition(int logicalIndex) const

Gibt die Position des Abschnitts im Ansichtsfenster des angegebenen logicalIndex zurück.

Wenn der Abschnitt ausgeblendet ist, ist der Rückgabewert undefiniert.

Siehe auch sectionPosition() und isSectionHidden().

[protected slot] void QHeaderView::sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)

Dieser Slot wird aufgerufen, wenn Abschnitte aus dem parent entfernt werden. logicalFirst und logicalLast geben an, wo die Abschnitte entfernt wurden.

Wenn nur ein Abschnitt entfernt wird, sind logicalFirst und logicalLast identisch.

bool QHeaderView::sectionsClickable() const

Gibt sectionsClickable zurück.

Siehe auch setSectionsClickable().

bool QHeaderView::sectionsHidden() const

Gibt true zurück, wenn Abschnitte in der Kopfzeile ausgeblendet wurden; andernfalls wird false zurückgegeben;

Siehe auch setSectionHidden().

[protected slot] void QHeaderView::sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

Dieser Slot wird aufgerufen, wenn Abschnitte in parent eingefügt werden. Die Indizes logicalFirst und logicalLast geben an, wo die neuen Abschnitte eingefügt wurden.

Wenn nur ein Abschnitt eingefügt wird, sind logicalFirst und logicalLast identisch.

bool QHeaderView::sectionsMovable() const

Gibt sectionsMovable zurück.

Siehe auch setSectionsMovable().

bool QHeaderView::sectionsMoved() const

Gibt true zurück, wenn Abschnitte in der Kopfzeile verschoben wurden; andernfalls wird false zurückgegeben;

Siehe auch moveSection().

[override virtual] void QHeaderView::setModel(QAbstractItemModel *model)

Reimplements: QAbstractItemView::setModel(QAbstractItemModel *model).

[slot] void QHeaderView::setOffset(int offset)

Setzt den Offset der Kopfzeile auf offset.

Siehe auch offset() und length().

[slot] void QHeaderView::setOffsetToLastSection()

Legt den Versatz fest, um den letzten Abschnitt sichtbar zu machen.

Siehe auch setOffset(), sectionPosition(), und setOffsetToSectionPosition().

[slot] void QHeaderView::setOffsetToSectionPosition(int visualSectionNumber)

Setzt den Versatz zum Beginn des Abschnitts an der angegebenen visualSectionNumber. visualSectionNumber ist der tatsächlich sichtbare Abschnitt, wenn hiddenSections nicht berücksichtigt werden. Das ist nicht immer dasselbe wie visualIndex().

Siehe auch setOffset() und sectionPosition().

void QHeaderView::setResizeContentsPrecision(int precision)

Legt fest, wie genau QHeaderView die Größe berechnen soll, wenn ResizeToContents verwendet wird. Ein niedriger Wert sorgt für eine weniger genaue, aber schnelle automatische Größenanpassung, während ein höherer Wert eine genauere Größenanpassung bewirkt, die jedoch langsam sein kann.

Die Zahl precision gibt an, wie viele Abschnitte bei der Berechnung der bevorzugten Größe berücksichtigt werden sollen.

Der Standardwert ist 1000, was bedeutet, dass eine horizontale Spalte mit automatischer Größenanpassung maximal 1000 Zeilen bei der Berechnung der automatischen Größenanpassung berücksichtigt.

Der spezielle Wert 0 bedeutet, dass nur der sichtbare Bereich berücksichtigt wird. Der spezielle Wert -1 bedeutet, dass alle Elemente betrachtet werden.

Dieser Wert wird in QTableView::sizeHintForColumn(), QTableView::sizeHintForRow() und QTreeView::sizeHintForColumn() verwendet. Eine Neuimplementierung dieser Funktionen kann dazu führen, dass diese Funktion keine Wirkung hat.

Siehe auch resizeContentsPrecision(), setSectionResizeMode(), resizeSections(), QTableView::sizeHintForColumn(), QTableView::sizeHintForRow(), und QTreeView::sizeHintForColumn().

void QHeaderView::setSectionHidden(int logicalIndex, bool hide)

Wenn hide wahr ist, wird der durch logicalIndex angegebene Abschnitt ausgeblendet; andernfalls wird der Abschnitt angezeigt.

Siehe auch isSectionHidden() und hiddenSectionCount().

void QHeaderView::setSectionResizeMode(QHeaderView::ResizeMode mode)

Setzt die Beschränkungen für die Größenänderung der Kopfzeile auf die durch die angegebene mode beschriebenen Beschränkungen.

Siehe auch sectionResizeMode(), length(), und sectionResized().

void QHeaderView::setSectionResizeMode(int logicalIndex, QHeaderView::ResizeMode mode)

Legt die Einschränkungen fest, wie der durch logicalIndex angegebene Abschnitt in der Kopfzeile auf die durch den angegebenen mode beschriebenen Größen angepasst werden kann. Der logische Index sollte zum Zeitpunkt des Aufrufs dieser Funktion vorhanden sein.

Siehe auch setStretchLastSection() und resizeContentsPrecision().

void QHeaderView::setSectionsClickable(bool clickable)

Setzen Sie sectionsClickable auf clickable.

Siehe auch sectionsClickable().

void QHeaderView::setSectionsMovable(bool movable)

Setzt sectionsMovable auf movable.

Siehe auch sectionsMovable().

[override virtual protected] void QHeaderView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Reimplements: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Wählt die Elemente in der angegebenen rect entsprechend der angegebenen flags aus.

Die Implementierung der Basisklasse tut nichts.

void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)

Setzt den Sortierindikator für den Abschnitt, der durch die angegebene logicalIndex angegeben ist, in die durch order angegebene Richtung und entfernt den Sortierindikator von allen anderen Abschnitten, die ihn anzeigten.

logicalIndex kann -1 sein. In diesem Fall wird kein Sortierindikator angezeigt und das Modell kehrt zu seiner natürlichen, unsortierten Reihenfolge zurück. Beachten Sie, dass nicht alle Modelle dies unterstützen und in diesem Fall sogar abstürzen können.

Siehe auch sortIndicatorSection() und sortIndicatorOrder().

[override virtual] void QHeaderView::setVisible(bool v)

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::visible.

void QHeaderView::showSection(int logicalIndex)

Zeigt den durch logicalIndex angegebenen Abschnitt an.

Siehe auch hideSection(), isSectionHidden(), hiddenSectionCount(), und setSectionHidden().

[override virtual] QSize QHeaderView::sizeHint() const

Reimplements: QAbstractScrollArea::sizeHint() const.

Gibt einen geeigneten Größenhinweis für diesen Header zurück.

Siehe auch sectionSizeHint().

[signal] void QHeaderView::sortIndicatorChanged(int logicalIndex, Qt::SortOrder order)

Dieses Signal wird ausgegeben, wenn der Abschnitt, der den Sortierindikator enthält, oder die angegebene Reihenfolge geändert wird. Der logische Index des Abschnitts wird durch logicalIndex und die Sortierreihenfolge durch order angegeben.

Siehe auch setSortIndicator().

Qt::SortOrder QHeaderView::sortIndicatorOrder() const

Gibt die Reihenfolge für den Sortierindikator zurück. Wenn kein Abschnitt einen Sortierindikator hat, ist der Rückgabewert dieser Funktion undefiniert.

Siehe auch setSortIndicator() und sortIndicatorSection().

int QHeaderView::sortIndicatorSection() const

Gibt den logischen Index des Abschnitts zurück, der einen Sortierindikator hat. Standardmäßig ist dies Abschnitt 0.

Siehe auch setSortIndicator(), sortIndicatorOrder(), und setSortIndicatorShown().

int QHeaderView::stretchSectionCount() const

Gibt die Anzahl der Abschnitte zurück, die auf den Größenänderungsmodus Stretch eingestellt sind. In Ansichten kann dies verwendet werden, um zu sehen, ob die Kopfansicht die Größe der Abschnitte ändern muss, wenn sich die Geometrie der Ansicht ändert.

Siehe auch stretchLastSection.

void QHeaderView::swapSections(int first, int second)

Tauscht den Abschnitt mit dem visuellen Index first mit dem Abschnitt mit dem visuellen Index second aus.

Siehe auch moveSection().

[override virtual protected] int QHeaderView::verticalOffset() const

Reimplements: QAbstractItemView::verticalOffset() const.

Gibt den vertikalen Versatz der Kopfzeile zurück. Dieser ist 0 für horizontale Kopfzeilen.

Siehe auch offset().

[override virtual protected] bool QHeaderView::viewportEvent(QEvent *e)

Reimplements: QAbstractItemView::viewportEvent(QEvent *Event).

int QHeaderView::visualIndex(int logicalIndex) const

Gibt die Position des visuellen Indexes des Abschnitts zurück, der durch die angegebene logicalIndex angegeben ist, oder andernfalls -1.

Ausgeblendete Abschnitte haben weiterhin gültige visuelle Indizes.

Siehe auch logicalIndex().

int QHeaderView::visualIndexAt(int position) const

Gibt den visuellen Index des Abschnitts zurück, der den angegebenen position im Ansichtsfenster abdeckt.

Siehe auch logicalIndexAt().