1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: fix linking issue in QHeaderView; reflow

Browse Source 
QHeaderView has no resizeMode property, only a ResizeMode enum type that
is then used in the sectionResizeMode API.

Fix that reference, reflow the paragraph, and apply some light editing.

Amends 9e3a96189d9db8a458e65cd5078509afe7a160db

Pick-to: 6.9
Change-Id: I240c3f64fd45c96f4d3ba95c2086a638468e137f
Reviewed-by: Christian Ehrlicher <ch.ehrlicher@gmx.de>
Reviewed-by: Thorbjørn Lund Martsum <tmartsum@gmail.com>
This commit is contained in:
Volker Hilsheimer 2025-01-17 16:44:00 +01:00
parent 2de013eb6f
commit 988a3cd95d
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
src/widgets/itemviews/qheaderview.cpp
View File

@ -130,16 +130,16 @@ static const int maxSizeSection = 1048575; // since section size is in a bitfiel
\section1 Special consideration for huge models
The headerview uses 8 to 16 bytes of memory per section.
However, since Qt 6.9 this section memory is only used if one
or more sections are resized or reordered. This means that it's possible
for a model to have millions of sections without QHeaderView consuming a proportional,
and therefore huge, amount of memory, as long as there are \e no calls to
\l swapSections, \l resizeSection, \l hideSection, \l moveSection,
and \l stretchLastSection (enabling it).
In order to avoid such calls by user actions the \l resizeMode
should be fixed (without specifying it for any indexes as
that will do the opposite). The user should also be prevented from
The headerview uses 8 to 16 bytes of memory per section. However, since Qt
6.9 this section memory is only used if one or more sections are resized or
reordered. This means that it's possible for a model to have millions of
sections without QHeaderView consuming a proportional, and therefore huge,
amount of memory, as long as there are \e no calls to \l swapSections, \l
resizeSection, \l hideSection, \l moveSection, and \l stretchLastSection
(enabling it). In order to avoid such calls by user actions the
\l{QHeaderView::sectionResizeMode}{resize mode} should be
\l{QHeaderView::ResizeMode}{Fixed} (without specifying it for any indexes,
as that will do the opposite). The user should also be prevented from
moving sections by keeping \l sectionsMovable disabled.
*/