doc: Improve QTextTableFormat::setBorderCollapse and related docs

We changed the default in 6.8. It was documented in the changelog but
not in docs. Amends 09ea47f8113bdce437253b19a91f739aeef7a333

Pick-to: 6.8
Fixes: QTBUG-132173
Change-Id: I1b6bf69931ba12025cf95e80c12a5073a94af598
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
(cherry picked from commit 622133ace2533617f294b8d875b5eb749a78571b)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Shawn Rutledge 2025-01-21 19:08:00 +01:00 committed by Qt Cherry-pick Bot
parent dac4298b72
commit a4dc60e9fc

View File

@ -3291,7 +3291,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
\fn void QTextTableFormat::setBorderCollapse(bool borderCollapse)
\since 5.14
Enabling \a borderCollapse will have the following implications:
By default, \l borderCollapse() is \c true, which has the following implications:
\list
\li The borders and grid of the table will be rendered following the
CSS table \c border-collapse: \c collapse rules
@ -3308,10 +3308,12 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
\endlist
\endlist
With borderCollapse disabled, cell borders can still be styled
With \a borderCollapse set to \c false, cell borders can still be styled
using QTextTableCellFormat but styling will be applied only within
the cell's frame, which is probably not very useful in practice.
\note In Qt versions prior to 6.8, the default value was \c false.
\sa setBorder(), setBorderBrush(), setBorderStyle()
\sa QTextTableCellFormat
*/
@ -3320,7 +3322,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
\fn bool QTextTableFormat::borderCollapse() const
\since 5.14
Returns true if borderCollapse is enabled.
Returns \c true if table borders are to be collapsed. The default is \c true.
\sa setBorderCollapse()
*/