Doc: Improve deprecation description for QApplication::fontMetrics()

Add a link to QFontMetrics, which provides more information about the
differences between QFontMetrics and QFontMetricsF and why the latter
is the preferred choice.

Fixes: QTBUG-127528
Pick-to: 6.9 6.8 6.5 6.2
Change-Id: Ib5713a9d39bf312a6eae6b8b1a6d1dc1d47e25be
Reviewed-by: Marcus Tillmanns <marcus.tillmanns@qt.io>
Reviewed-by: Christian Ehrlicher <ch.ehrlicher@gmx.de>
This commit is contained in:
Andreas Eliasson 2025-02-04 07:05:59 +01:00
parent 9b475eadfc
commit bdf453afd7
2 changed files with 8 additions and 4 deletions

View File

@ -1574,14 +1574,18 @@ QWidget *QApplication::activeWindow()
return QApplicationPrivate::active_window;
}
#if QT_DEPRECATED_SINCE(6,0)
/*!
\deprecated Use the QFontMetricsF constructor instead.
Returns display (screen) font metrics for the application font.
\fn QFontMetrics QApplication::fontMetrics()
\deprecated [6.0] Use QFontMetricsF(qApp->font()) instead.
Returns display (screen) font metrics for the application font. For more
information about the difference between \l QFontMetrics and \l QFontMetricsF,
see the detailed description of \l QFontMetrics.
\sa font(), setFont(), QWidget::fontMetrics(), QPainter::fontMetrics()
*/
#if QT_DEPRECATED_SINCE(6,0)
QFontMetrics QApplication::fontMetrics()
{
return QApplicationPrivate::desktop()->fontMetrics();

View File

@ -66,7 +66,7 @@ public:
static void setFont(const QFont &, const char* className = nullptr);
#if QT_DEPRECATED_SINCE(6,0)
QT_DEPRECATED_VERSION_X_6_0("Use the QFontMetricsF constructor instead.")
QT_DEPRECATED_VERSION_X_6_0("Use QFontMetricsF(qApp->font()) instead.")
static QFontMetrics fontMetrics();
#endif