docs/checks/README-qt6-deprecated-api-fixes.md

0001 Warn against deprecated API in Qt6
0002
0003 The code is fixed when possible.
0004
0005 * `QDate::toString(Qt::DateFormat format, QCalendar cal)` becomes  `QDate::toString(Qt::DateFormat format)`.
0006
0007 * `QDateTime(const QDate &)` becomes `QDate::startOfDay()`.
0008
0009 * `QDir dir; dir = "..."` becomes       `QDir dir; dir.setPath("...")`.
0010
0011 * `QDir::addResourceSearchPath()` becomes `QDir::addSearchPath()` with prefix.
0012
0013 * Only warning are emitted for `addResourceSearchPath`.
0014
0015 * `QProcess::start()` becomes `QProcess::startCommand()`.
0016
0017 * `QResource::isCompressed()` is replaced with `QResource::compressionAlgorithm()`.
0018
0019 * `QSignalMapper::mapped()` is replaced with `QSignalMapper::mappedInt`, `QSignalMapper::mappedString`, `QSignalMapper::mappedObject` depending on the argument of the function.
0020
0021 * `QString::SplitBehavior` is replaced with `Qt::SplitBehavior`.
0022
0023 * `Qt::MatchRegExp` is replaced with `Qt::MatchRegularExpression`.
0024
0025 * `QTextStream` functions are replaced by the one under the Qt namespace.
0026
0027 * `QVariant` operators '`<`' '`<=`' '`>`' '`>=`' are replaced with `QVariant::compare()` function.
0028
0029 * `QVariant v1; QVariant v2; 'v1 < v2'` becomes '`QVariant::compare(v1, v2) < 0`'.
0030
0031 * `QWizard::visitedPages()` is replaced with `QWizard::visitedIds()`.
0032
0033 * `QButtonGroup buttonClicked/Pressed/Released/Toggled(int)` is replaced with `QButtonGroup::idClicked/Pressed/Released/Toggled(int)`.
0034
0035 * `QCombobox::activated(const QString &)` and `highlighted(const QString &)` are replaced with `QComboBox::textActivated` or `textHighlighted` respectively.
0036
0037 Warning for:
0038
0039 * Usage of `QMap::insertMulti`, `uniqueKeys`, `values`, `unite`, to be replaced with QMultiMap versions.
0040
0041 * Usage of `QHash::uniqueKeys`, to be replaced with `QMultiHash` versions.
0042
0043 * Usage of `LinkedList`, to be replaced with `std::list`.
0044
0045 * Usage of global `qrand()` and `qsrand()`, to be replaced using `QRandomGenerator`.
0046
0047 * Usage of `QTimeLine::curveShape` and `QTimeLine::setCurveShape`, to be replaced using `QTimeLine::easingCurve` and `QTimeLine::setEasingCurve`.
0048
0049 * Usage of `QSet` and `QHash` biderectional iterator. Code has to be ported using forward iterator.
0050
0051 * Usage of `QMacCocoaViewContainer`, to be replaced using `QWindow::fromWinId` and `QWidget::createWindowContainer` instead.
0052
0053 * Usage of `QMacNativeWidget`, to be replaced using `QWidget::winId` instead.
0054
0055 * Usage of `QComboBox::SizeAdjustPolicy::AdjustToMinimumContentsLength`, to be replaced using `AdjustToContents` or `AdjustToContentsOnFirstShow`.
0056
0057 * Usage of `QComboBox::currentIndexChanged(const QString &)`, to be replaced using `currentIndexChanged(int)` instead, and getting the text using `itemText(index)`.
0058
0059 * Usage of `QSplashScreen(QWidget *parent,...)`, to be replaced with the constructor taking a `QScreen *`.
0060
0061 * Usage of `QTextBrowser::highlighted(const QString &)`, to be replaced with `highlighted(const QUrl &)`.
0062
0063 * Usage of `QDockWidget::AllDockWidgetFeatures`, to  be replaced with  `DockWidgetClosable|DockWidgetMovable|DockWidgetFloatable`.
0064
0065 * Usage of `QDirModel`, to be replaced with `QFileSystemModel`.
0066
0067 * Usage of `QGraphicsView::matrix`, `setMatrix(const QMatrix &)` and `resetMatrix`, to be replaced with `QGraphicsView::transform`, `setTransform(const QTransform &)` and `resetTransfrom`.
0068
0069 * Usage of the following QStyle enum: `QStyle::PixelMetrix::PM_DefaultTopLevelMargin`, `PM_DefaultChildMargin`, `PM_DefaultLayoutSpacing` and `QStyle::SubElement::SE_DialogButtonBoxLayoutItem`.
0070
0071 This fix-it is intended to aid the user porting from Qt5 to Qt6.
0072 Run this check with Qt5. The produced fixed code will compile on Qt6.