QHeaderView Class

Dokumentation zu Mitgliedsfunktionen

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

Erstellt einen neuen generischen Header mit den angegebenen Attributen „ orientation “ und „ parent “.

[virtual noexcept] QHeaderView::~QHeaderView()

Löscht die Kopfzeile.

int QHeaderView::count() const

Gibt die Anzahl der Abschnitte im Header zurück.

Siehe auch „ sectionCountChanged()“ und „ length()“.

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

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

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

Umsetzt: ` QAbstractItemView::event(QEvent *event)`.

[signal] void QHeaderView::geometriesChanged()

Dieses Signal wird ausgesendet, wenn sich die Geometrien des Headers geändert haben.

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

Aktualisiert die geänderten Kopfzeilenabschnitte mit der angegebenen URL „ orientation “, von „ logicalFirst “ bis einschließlich „ logicalLast “.

int QHeaderView::hiddenSectionCount() const

Gibt die Anzahl der im Kopfbereich ausgeblendeten Abschnitte zurück.

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

Implementiert neu: ` QAbstractItemView::horizontalOffset()` const.

Gibt den horizontalen Versatz der Kopfzeile zurück. Bei vertikalen Kopfzeilen ist dieser Wert 0.

Siehe auch offset().

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

Initialisieren Sie „ option “ mit den Werten aus dieser Datei: QHeaderView. Diese Methode ist für Unterklassen nützlich, wenn diese ein „ QStyleOptionHeader “ benötigen, aber nicht alle Informationen selbst eingeben möchten.

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

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

Initialisiert den Stil „ option “ anhand der 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 für den Benutzer explizit ausgeblendet ist; andernfalls wird „ false “ zurückgegeben.

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

int QHeaderView::length() const

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

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

int QHeaderView::logicalIndex(int visualIndex) const

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

Beachten Sie, dass der „ visualIndex “ nicht von ausgeblendeten 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. Ist die Kopfzeile horizontal ausgerichtet, wird die x-Koordinate verwendet; andernfalls wird die y-Koordinate zur Ermittlung des logischen Index herangezogen.

Siehe auch sectionPosition().

int QHeaderView::logicalIndexAt(int position) const

Gibt den Ausschnitt zurück, der die angegebene Koordinaten position im Ansichtsbereich 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. Befindet sich die Kopfzeile horizontal, wird „ x “ verwendet; andernfalls wird „ y “ verwendet, um den logischen Index zu ermitteln.

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

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

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

Implementiert: ` QAbstractItemView::mouseMoveEvent` (`QMouseEvent *event`).

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

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

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

Implementiert: ` QAbstractItemView::mouseReleaseEvent` (`QMouseEvent *event`).

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

Verschiebt den Abschnitt am visuellen Index from so, dass er den visuellen Index to einnimmt.

Siehe auch sectionsMoved().

int QHeaderView::offset() const

Gibt den Versatz der Kopfzeile zurück: Dabei handelt es sich um das am weitesten links (bzw. bei vertikalen Kopfzeilen am weitesten oben) liegende 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)

Umsetzt: ` QAbstractScrollArea::paintEvent` (`QPaintEvent *event`).

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

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

Normalerweise müssen Sie diese Funktion nicht aufrufen.

[override virtual] void QHeaderView::reset()

Implementiert: QAbstractItemView::reset().

int QHeaderView::resizeContentsPrecision() const

Gibt an, mit welcher Genauigkeit „ QHeaderView “ auf „ ResizeToContents “ berechnet wird.

Siehe auch setResizeContentsPrecision() und setSectionResizeMode().

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

Passen Sie die Größe des durch logicalIndex angegebenen Abschnitts auf size an (in Pixeln). Der Parameter „size“ muss einen Wert größer oder gleich Null haben. Ein Wert von Null wird jedoch nicht empfohlen. In diesem Fall sollte stattdessen hideSection verwendet werden.

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

[protected slot] void QHeaderView::resizeSections()

Passen Sie die Größe der Abschnitte entsprechend ihren Größenangaben an. Normalerweise müssen Sie diese Funktion nicht aufrufen.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        headerView, qOverload<>(&QHeaderView::resizeSections));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        headerView, [receiver = headerView]() { receiver->resizeSections(); });

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

Passen Sie die Größe der Abschnitte entsprechend der angegebenen „ mode “ an und ignorieren Sie dabei den aktuellen Größenanpassungsmodus.

Siehe auch ` sectionResized()`.

bool QHeaderView::restoreState(const QByteArray &state)

Stellt den „ state “ dieser Header-Ansicht wieder her. Diese Funktion gibt „ true “ zurück, wenn der Zustand wiederhergestellt wurde; andernfalls gibt sie „false“ zurück.

Siehe auch „ saveState()“.

QByteArray QHeaderView::saveState() const

Speichert den aktuellen Zustand dieser Header-Ansicht.

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

Siehe auch ` restoreState()`.

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

Dieses Signal wird ausgelöst, wenn auf einen Abschnitt geklickt wird. Der logische Index des Abschnitts wird durch „ logicalIndex “ angegeben.

Beachten Sie, dass auch das Signal ` sectionPressed ` ausgelöst wird.

Siehe auch „ setSectionsClickable “ () und „ sectionPressed “ ().

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

Dieses Signal wird ausgelöst, 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 ausgelöst, 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 ausgelöst, wenn der Cursor über den Abschnitt bewegt 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 ausgelöst, 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 ausgelöst, 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 Abschnittsposition des angegebenen ` logicalIndex` zurück oder -1, wenn der Abschnitt ausgeblendet ist. Die Position wird in Pixeln gemessen, und zwar von der linken oberen Ecke des ersten sichtbaren Elements bis zur linken oberen Ecke des Elements mit ` logicalIndex`. Die Messung erfolgt entlang der x-Achse bei horizontalen Kopfzeilen und entlang der y-Achse bei vertikalen Kopfzeilen.

Siehe auch ` sectionViewportPosition()`.

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

Dieses Signal wird ausgelöst, 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 ausgelöst, 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 (bzw. bei vertikalen Kopfzeilen die Höhe) des 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 durch die angegebene ` logicalIndex` angegebenen Abschnitts zurück.

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 Schnitt-Viewports des angegebenen „ logicalIndex “ zurück.

Ist der Abschnitt ausgeblendet, 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 der Datei „ parent “ entfernt werden. „ logicalFirst “ und „ logicalLast “ geben an, wo die Abschnitte entfernt wurden.

Wird nur ein Abschnitt entfernt, sind logicalFirst und logicalLast identisch.

bool QHeaderView::sectionsClickable() const

Gibt die Abschnitte „Clickable“ zurück.

Siehe auch „ setSectionsClickable()“.

bool QHeaderView::sectionsHidden() const

Gibt „ true “ zurück, wenn Abschnitte im Header 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 die Datei „ parent “ eingefügt werden. Die Indizes „ logicalFirst “ und „ logicalLast “ geben an, an welcher Stelle die neuen Abschnitte eingefügt wurden.

Wird nur ein Abschnitt eingefügt, sind „ logicalFirst “ und „ logicalLast “ identisch.

bool QHeaderView::sectionsMovable() const

Gibt die Abschnitte von „Movable“ zurück.

Siehe auch „ setSectionsMovable()“.

bool QHeaderView::sectionsMoved() const

Gibt „ true “ zurück, wenn Abschnitte im Header verschoben wurden; andernfalls wird „false“ zurückgegeben;

Siehe auch ` moveSection()`.

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

Implementiert: ` QAbstractItemView::setModel(QAbstractItemModel *model)`.

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

Setzt den Versatz 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 Anfang des Abschnitts unter der angegebenen visualSectionNumber. visualSectionNumber ist der tatsächlich sichtbare Abschnitt, wenn hiddenSections nicht berücksichtigt werden. Dies entspricht nicht immer dem Wert von 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 ermöglicht, 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 bei einer horizontalen Spalte mit automatischer Größenanpassung bei der Berechnung maximal 1000 Zeilen berücksichtigt werden.

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

Dieser Wert wird in den Funktionen „ QTableView::sizeHintForColumn()“, „ QTableView::sizeHintForRow()“ und „ QTreeView::sizeHintForColumn()“ verwendet. Durch eine Neuimplementierung dieser Funktionen kann die Wirkung dieser Funktion aufgehoben werden.

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)

Legt die Einschränkungen für die Größenänderung der Kopfzeile so fest, wie sie in der angegebenen Datei „ mode “ beschrieben sind.

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

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

Legt fest, dass die Größenänderung des durch „ logicalIndex “ in der Kopfzeile angegebenen Abschnitts auf die durch den angegebenen „ mode “ beschriebenen Werte beschränkt wird. 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)

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

Wählt die Elemente im angegebenen ` rect ` gemäß den angegebenen ` flags` aus.

Die Implementierung der Basisklasse führt keine Aktion aus.

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

Setzt die Sortiermarkierung für den durch die angegebene ` logicalIndex ` festgelegten Abschnitt in die durch ` order` angegebene Richtung und entfernt die Sortiermarkierung aus allen anderen Abschnitten, in denen sie angezeigt wurde.

logicalIndex Der Wert 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)

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::visible “ neu.

void QHeaderView::showSection(int logicalIndex)

Zeigt den Abschnitt an, der durch logicalIndex angegeben ist.

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

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

Implementiert neu: ` 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 ausgelöst, wenn der Abschnitt, der das Sortierkennzeichen enthält, oder die angegebene Reihenfolge geändert wird. Der logische Index des Abschnitts wird durch logicalIndex angegeben, und die Sortierreihenfolge wird durch order angegeben.

Siehe auch setSortIndicator().

Qt::SortOrder QHeaderView::sortIndicatorOrder() const

Gibt die Reihenfolge für das Sortierkennzeichen zurück. Wenn kein Abschnitt ein Sortierkennzeichen 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 über ein Sortierkennzeichen verfügt. Standardmäßig ist dies Abschnitt 0.

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

int QHeaderView::stretchSectionCount() const

Gibt die Anzahl der Abschnitte zurück, für die der Größenanpassungsmodus „stretch“ eingestellt ist. In Ansichten kann dies verwendet werden, um festzustellen, ob die Headerview die Größe der Abschnitte anpassen muss, wenn sich die Geometrie der Ansicht ändert.

Siehe auch stretchLastSection.

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

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

Siehe auch moveSection().

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

Implementiert neu: ` QAbstractItemView::verticalOffset()` const.

Gibt den vertikalen Versatz der Kopfzeile zurück. Bei horizontalen Kopfzeilen ist dieser Wert 0.

Siehe auch offset().

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

Umsetzt: ` QAbstractItemView::viewportEvent(QEvent *event)`.

int QHeaderView::visualIndex(int logicalIndex) const

Gibt die Position des visuellen Indexes des durch die angegebene ` logicalIndex` angegebenen Abschnitts zurück oder andernfalls -1.

Auch ausgeblendete Abschnitte verfügen weiterhin über gültige visuelle Indizes.

Siehe auch ` logicalIndex()`.

int QHeaderView::visualIndexAt(int position) const

Gibt den visuellen Index des Abschnitts zurück, der die angegebene position im Ansichtsbereich abdeckt.

Siehe auch ` logicalIndexAt()`.