QImage: fix documentation of toCGImage

Remove the \brief section, which qdoc doesn't support for functions.
Explicitly use \fn to link the documentation, as qdoc doesn't always see
the declaration.

This makes the function not only public, but also documented API,
similar to QImage::toHBITMAP and toHICON. In practice, this is what
was intended, so fixing this in stable branches as well.

Pick-to: 6.5
Change-Id: Id825e494d13f10064742318d2b3bbd8f8f7a1435
Reviewed-by: Tor Arne Vestbø <tor.arne.vestbo@qt.io>
(cherry picked from commit 26375032c92b8729ca5625c225e99a696d7b6b9e)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
bb10
Volker Hilsheimer 2024-10-22 12:01:36 +02:00 committed by Qt Cherry-pick Bot
parent 0f23f9c136
commit 2997feb230
1 changed files with 3 additions and 2 deletions

View File

@ -12,9 +12,10 @@
QT_BEGIN_NAMESPACE
/*!
\brief Creates a \c CGImage equivalent to this QImage.
\fn CGImageRef QImage::toCGImage() const
Returns a \c CGImageRef handle.
Creates a \c CGImage equivalent to this QImage, and returns a \c CGImageRef
handle.
The returned CGImageRef partakes in the QImage implicit sharing,
and holds a reference to the QImage data. CGImage is immutable