C++ API changes

Qt 5 introduces some source incompatible changes. Here we list some important ones, but you can find more complete lists in <Qt 5 Install Dir>/qtbase/dist/changes-5.x.x .

The following sections list the API changes in each module and provide recommendations for handling those changes.

Qt Core 的变化

• QLibrary::resolve () now returns a function pointer instead of void 指针。
• QLibraryInfo::buildKey() 和相应 QT_BUILD_KEY macro are removed. You must remove all references to this function and macro, as build key is not necessary now.
• The QTranslator::translate () function signature is changed to set the default value of n to -1. We recommend you to update the implementation of this virtual function in your sources.
• QBool is removed. In Qt 4, QString::contains (), QByteArray::contains ()，和 QList::contains () returned an internal QBool type so that the Qt3 code if (a.contains() == 2) would not compile anymore. If your code uses QBool , replace it with bool .
• The QUuid::operator QString() implicit conversion operator is removed. Use the QUuid::toString () 函数代替。
• QProcess::ForwardedChannels no longer forwards the output to the GUI applications on the Windows platform, unless those applications create a console.
• QSystemLocale is not public anymore. Use QLocale 代替。
• Default value of the QSortFilterProxyModel::dynamicSortFilter property is changed to true .
• QTextCodecPlugin is removed as all the text codecs are part of Qt Core now.
• QFSFileEngine , QAbstractFileEngine , QAbstractFileEngineIterator ，和 QAbstractFileEngineHandler are no longer public. We recommend you to avoid using these classes as there is no compatibility promise.
• qDebug (), qWarning (), qCritical ()，和 qFatal () are changed to macros now to track the origin of the message in source code. The information to be printed can be configured (for the default message handler) by setting the new QT_MESSAGE_PATTERN 环境变量。 qInstallMsgHandler () is deprecated, so we recommend using qInstallMessageHandler () 代替。
• QPointer is changed to use QWeakPointer . The old guard mechanism has been removed, which causes a slight change in behavior when using QPointer . In earlier Qt versions, if a QPointer is used on a QWidget (or a subclass of QWidget )， QPointer was cleared by the QWidget destructor. In Qt 5, the QPointer is cleared by the QObject destructor along with the QWeakPointer s. Any QPointer tracking a widget is not cleared before the QWidget destructor destroys the children for the widget being tracked.
• Qt::WFlags is deprecated, use Qt::WindowFlags instead. This typedef dates from the Qt 1 days, and such abbreviations are not current Qt style.
• Qt::HANDLE typedef is now defined as void * 在所有平台。
• The non-atomic convenience methods of QAtomicInt and QAtomicPointer (that is, operator= , operator int , operator T* , operator! , operator== , operator!= ，和 operator-> ) have been removed as they performed implicit loads and stores of unspecified memory ordering. Code dealing with loading and storing is expected to use load() , loadAquire() , store() ，和 storeRelease() , instead.
• The return type of QFlags<Enum>::operator int() matches the enum's underlying type (signed or unsigned) instead of always being int . This allows QFlags over enums of the unsigned type (for example, Qt::MouseButton ).
• Because of major changes in the behavior of QTextBoundaryFinder::boundaryReasons ()， StartWord and EndWord enum values were replaced with the StartOfItem and EndOfItem values to enforce revision of the affected code.
• A number of functions in <QtAlgorithms> are deprecated. Use the implementations available in the STL, as described in Porting Guidelines .
• setSharable() and isSharable() in Qt containers are deprecated and will be removed in Qt 6. You should not use them in new applications. If you used them in existing applications, even though they are not documented, you should port away from them.

Changes to QAction

The Softkeys API is removed, so the following functions and enums are removed:

• QAction::setSoftKeyRole()
• QAction::softKeyRole()
• QAction::SoftKeyRole
• Qt::WA_MergeSoftkeys
• Qt::WA_MergeSoftkeysRecursively
• Qt::WindowSoftkeysVisibleHint
• Qt::WindowSoftkeysRespondHint

Changes to QChar

• QChar::NoCategory is removed. The QChar::Other_NotAssigned enum value is returned for unassigned codepoints now.
• QChar::Joining and QChar::joining () are deprecated. Use the QChar::JoiningType enum and QChar::joiningType () 函数代替。

Changes to QCoreApplication

• QCoreApplication::translate () no longer returns the source text if the translation is empty. Use the Qt Linguist Release tool ( lrelease -removeidentical ) instead for optimization.
• QCoreApplication::setEventFilter() and QApplication::x11EventFilter/macEventFilter/qwsEventFilter/winEventFilter are replaced with QCoreApplication::installNativeEventFilter () 和 QCoreApplication::removeNativeEventFilter () for an API much closer to QEvent filtering.

  注意： The native events that can be filtered this way depend on the QPA backend chosen at runtime. On X11, XEvents are replaced with xcb_generic_event_t due to the switch to XCB, which requires porting the application code to XCB as well.

• QCoreApplication::Type and QApplication::type() are removed. These Qt 3 legacy application types did not match the application types available in Qt 5. Use qobject_cast instead to dynamically find out the exact application type.
• QCoreApplication::hasPendingEvents and QAbstractEventDispatcher::hasPendingEvents 被弃用。

Changes to QEvent

• QEvent::AccessibilityPrepare , QEvent::AccessibilityHelp ，和 QEvent::AccessibilityDescription are removed.
• QEvent::TouchCancel is introduced to use it on systems where it makes sense to differentiate between a regular QEvent::TouchEnd and abrupt touch sequence cancellations caused by the compositor. For example, when a swype gesture is recognized.

Changes to QFile

• QFile::setEncodingFunction () 和 QFile::setDecodingFunction () are deprecated.
• QFile::encodeName () 和 QFile::decodeName () are now hard-coded to operate on QString::fromLocal8Bit () 和 QString::toLocal8Bit () only. The old behavior is still possible using QTextCodec::setCodecForLocale (), but the new code should not make assumptions about the file system encoding and older code should remove such assumptions.

Changes to QFont

• QFont::handle() is removed.
• QFont::rawName () 和 QFont::setRawName () are deprecated.

Changes to QMetaType

• QMetaType::construct() is renamed as QMetaType::create ().
• QMetaType::unregisterType() is removed.
• QMetaType now records whether the type argument inherits QObject . Such information can be useful for scripting APIs, so that custom QObject subclasses are treated as QObject pointers. For example, in Qt Script this means QScriptValue::isQObject () can be true , where it was false before.
• QMetaType::QWidgetStar is removed. Use qMetaTypeId<QWidget*> () 或 QVariant::canConvert<QWidget*> () 代替。
• Q_DECLARE_METATYPE(type) now requires type to be fully defined. This means, Q_DECLARE_METATYPE(QSharedPointer<t>) and Q_DECLARE_METATYPE(QWeakPointer<t>) also need type to be fully defined. In cases where a forward declared type is needed as a meta-type, use Q_DECLARE_OPAQUE_POINTER(type) .

Changes to QMetaMethod

• QMetaMethod::signature() is renamed as QMetaMethod::methodSignature (), and the return type is changed to QByteArray . This change is to enable generating the signature string on demand, rather than storing it in the meta-data.
• QMetaMethod::typeName () no longer returns an empty string if the return type is void , instead it returns "void" . The recommended way of checking whether a method returns void is to compare the return value of QMetaMethod::returnType () 采用 QMetaType::Void .

Changes to QObject

• QObject::connectNotify () 和 QObject::disconnectNotify () now need a QMetaMethod argument that identifies the signal, rather than a const char 指针。
• QObject::trUtf8 () 和 QCoreApplication::Encoding are deprecated. Qt assumes that the source code is encoded in UTF-8.

Changes to QVariant

• The QVariant constructor which takes Qt::GlobalColor argument is removed. Code constructing such variants must explicitly call QColor constructor now. For example, instead of QVariant(Qt::red) ，使用 QVariant(QColor(Qt::red)) to create a QVariant 实例。
• Implicit creation of QVariant objects from the enum values Qt::BrushStyle , Qt::PenStyle ，和 Qt::CursorShape has been removed. Create objects explicitly or use static_cast<int>(Qt::SolidLine) to create a QVariant 类型 int with the same value as the enum.

Changes to QAbstractEventDispatcher

• The signature for the pure-virtual registerTimer() function is changed. All subclasses of QAbstractEventDispatcher must re-implement the function with this new signature:

  virtual void registerTimer(int timerId, int interval,Qt::TimerType timerType, QObject *object) = 0;
  						

• QAbstractEventDispatcher::TimerInfo is no longer a typedef of QPair<int, int> . It is now a struct with 3 members: int timerId , int interval ，和 Qt::TimerType timerType . Update the QAbstractEventDispatcher::registeredTimers () function with this change.

Changes to QDir

• The convertSeparators() function is removed. Use QDir::toNativeSeparators () 代替。
• The QDir::NoDotAndDotDot enum value is removed. Use QDir::NoDot or QDir::NoDotDot 代替。

Changes to QLocale

• The QLocale data has been updated to CLDR 22.1. The historical language and country names were updated to their modern values and some deprecated names were dropped or mapped to their modern alternatives.
• The QLocale::toShort (), QLocale::toUShort (), QLocale::toInt (), QLocale::toUInt (), QLocale::toLongLong ()，和 QLocale::toULongLong () functions no longer take the argument for base. They localize base 10 conversions. To convert other bases, use the QString functions instead.

Changes to QAbstractItemModel

• QAbstractItemModel::beginMoveRows () no longer emits the layoutAboutToBeChanged signal, and QAbstractItemModel::endMoveRows () no longer emits the layoutChanged signal. All proxy models must connect to (and disconnect from) the QAbstractItemModel::rowsAboutToBeMoved and QAbstractItemModel::rowsMoved signals.
• QAbstractItemModel::sibling () is virtual now to allow implementations to optimize based on internal data.
• QAbstractItemModel::createIndex () method now only provides the void* and quintptr overloads, making calls with a literal 0 ( createIndex(row, col, 0) ) ambiguous. Either cast quintptr(0) or omit the third argument to get the void* overload.
• QAbstractItemModel::setRoleNames () is deprecated. Use QAbstractItemModel::roleNames () 代替。 QAbstractItemModel::roleNames () is virtual now to allow a consistent API with the rest of QAbstractItemModel . Reimplementing the virtual methods to provide the elements is preferred to setting those directly.

Changes to QString

• QString and QByteArray constructors now use a negative size to indicate that the string passed is null-terminated (a null-terminated array of QChar , in the case of QString ). In Qt 4, negative sizes were ignored, which resulted in empty QString and QByteArray . The size argument now has a default value of -1 , replacing the separate constructors that did the same.
• QString::mid (), QString::midRef ()，和 QByteArray::mid () now return an empty QString , QStringRef ，和 QByteArray respectively, if the position passed is equal to the length (that is, right after the last character or byte). In Qt 4, they returned a null QString or a null QStringRef .
• 下列 QString functions use the C locale instead of the default or system locale:
  • toLongLong()
  • toULongLong()
  • toLong()
  • toULong()
  • toInt()
  • toUInt()
  • toShort()
  • toUShort()
  • toDouble()
  • toFloat()

  This is to guarantee consistent default conversion of strings. For locale-aware conversions use the equivalent QLocale 函数。

Changes to QDate, QTime, and QDateTime

• QDate only implements the Gregorian calendar, and the switch to the Julian calendar before 1582 has been removed. This means all QDate functions return different results for dates prior to 15 October 1582, and there is no longer a gap between 4 October 1582 and 15 October 1582.
• QDate::setYMD () is deprecated, use QDate::setDate () 代替。
• Adding days to a null QDate or seconds to a null QTime will no longer return a valid QDate / QTime .
• The QDate::addDays () 和 QDateTime::addDays () functions now take a qint64 argument, and the QDate::daysTo () 和 QDateTime::daysTo () functions now return a qint64 值。
• QDate and QTime are the userProperty 为 QTimeEdit and QDateEdit classes, insted of QDateTime as it was for the 4.7 and 4.8 releases. The USER property for these classes was removed before Qt 4.7.0 and added again in Qt 5.0.
• The serialization behavior for QDateTime is reverted to pre-Qt 5, because Qt::LocalTime is the local time (that is, ymd hms ) regardless of the underlying system time, time zone, or changes in the system zone. Therefore, the consistent behavior when serialising is to save and restore as the local time and not its UTC equivalent. This means that the QDataStream version is 14 since Qt 5.1.
• The supported date range in QDateTime has been reduced to about +/- 292 million years, the range supported by the number of msecs since the Unix epoch of 1 Jan 1970 as stored in a qint64 , and as able to be used in QDateTime::setMSecsSinceEpoch () 和 QDateTime::toMSecsSinceEpoch ().
• QDate::fromString () 和 QDateTime::fromString () require non-numeric date component separators when parsing Qt::ISODate . A string like 2000901901 will no longer be recognized as a valid ISO date, whereas 2000/01/01 will, even though it differs from the ISO format 2000-01-01 .

Changes to QTextCodec

• QTextCodec::codecForCStrings() and QTextCodec::setCodecForCStrings() are removed as they were creating uncertainty/bugs in using QString easily and (to a lesser extent) performance issues.
• QTextCodec::codecForTr() and QTextCodec::setCodecForTr() are removed.

Changes to QUrl

QUrl changed considerably in Qt 5 to comply better with the URL specifications and with brokenness out there. The following list summarizes the most important functional changes:

• QUrl::setPath () no longer handles relative paths. They are by definition invalid. Use the QUrl::NormalizePathSegments flag to remove /./ or /../ sequences as much as possible. It will not remove /../ from the beginning of the path.
• QUrl has been changed to operate only on percent-encoded forms. Fully-decoded forms where the percent character stands for itself, can no longer be encoded, as the getters and setters with encoded in the name are deprecated (except QUrl::toEncoded () 和 QUrl::fromEncoded ()).

  The most notable difference with this change is when dealing with QUrl::toString (). In earlier Qt versions, this function would return percent characters in the URL, but now it returns %25 like QUrl::toEncoded () 做。

• QUrl no longer decodes %7B and %7D to "{" and "}" in the output of QUrl::toString ().
• QUrl now defaults to decoded mode in the getters and setters for userName , password , host , topLevelDomain , path and fileName . This means a % in one of those fields is now returned (or set) as % 而不是 %25 . If the former behavior was expected, pass PrettyDecoded to the getter and TolerantMode to the setter.
• QUrl no longer has functions that handle individual query items and query delimiters, such as addQueryItem() and queryPairDelimiter() . These have been moved to the new QUrlQuery 类。
• QUrl no longer considers all delimiter characters equivalent to their percent-encoded forms. QUrl and QUrlQuery always keep all delimiters exactly as they were in the original URL text.
• QUrl no longer supports QUrl::FullyDecoded mode in QUrl::authority () 和 QUrl::userInfo (), nor QUrl::DecodedMode in QUrl::setAuthority () 和 QUrl::setUserInfo ().
• QUrl no longer decodes %23 found in the fragment to "#" in the output of QUrl::toString ( FullyEncoded ) 或 QUrl::toEncoded ().

Qt Concurrent 的变化

Qt Concurrent has been moved from Qt Core to its own module. To link against the Qt Core module, add this line to the project file:

QT += concurrent
			

注意： The QtConcurrent::Exception class is renamed QException and QtConcurrent::UnhandledException class is renamed QUnhandledException . They remain in Qt Core.

Qt GUI 的变化

• QPen now has a default width of 1 instead of 0. Thus, it is no longer cosmetic 在默认情况下。
• QAccessibleActionInterface is now based on providing a list of action names. All functions have been changed to take arguments of type string insted of int .
• The constructor of QAccessibleEvent does not need the child parameter anymore, and the corresponding QAccessibleEvent::child() function is removed.
• The constructor of QTabletEvent does not need the hiResGlobalPos argument anymore, as all coordinates are floating point-based now.
• QIconEngineV2 is now merged into QIconEngine . Update your sources to use QIconEngine 而不是 QIconEngineV2 .
• QSound is moved to Qt Multimedia from Qt GUI.
• QDesktopServices::storageLocation() and QDesktopServices::displayName() are replaced by QStandardPaths::writableLocation () 和 QStandardPaths::displayName () respectively. They are now in the Qt Core module. Make sure to read the QDesktopServices::storageLocation () documentation when porting from QDesktopServices::DataLocation .
• QPixmap::grabWindow() and QPixmap::grabWidget() are removed. Use QScreen::grabWindow () 代替。
• The session management API has been simplified. The commitData() function is removed and replaced by the signal QGuiApplication::commitDataRequest (). QApplication and QGuiApplication will emit this signal from 5.2 onward on supported platforms (Linux and Windows).
• QWidget *widget() 被替换采用 QObject *target() to avoid QWidget dependencies.

Changes to QAccessibleInterface

• The child integer parameters are removed to bring QAccessibleInterface closer to IAccessible2 . This means that the following functions lose the integer parameter:
  • text(Text t, int child) 现为 text (Text t)
  • rect(int child) 现为 rect()
  • setText(Text t, int child, const QString &text) 现为 setText(Text t, const QString &text)
  • role(int child) 现为 role()
  • state(int child) 现为 state()
• navigate() 被替换采用 parent() and child() to navigate the hierarchy.
• relationTo() 被替换采用 relations() .
• QAccessibleInterface::userActionCount() , QAccessibleInterface::actionText() ，和 QAccessibleInterface::doAction() are removed. We recommend using the QAccessibleInterface subclasses to implement the QAccessibleActionInterface 代替。

Changes to QImage

• QImage::fill () on an image with format Format_RGB888 now expects image data in RGB layout as opposed to BGR layout. This is to ensure consistency with RGB32 and other 32-bit formats.
• 行为在 QImage::load (), QImage::loadFromData (), QPixmap::load ()，和 QPixmap::loadFromData () on a non-null image changed so that if the functions fail to load the image (return false ), the the existent image data is invalidated, so that isNull() is guaranteed to return true 在此情况下。

Changes to QPainter

• QPainter does not support uniting clipped regions anymore. Use QRegion::united () instead to unite clips and pass the result to QPainter .
• QPainter fill rules when not using antialiased painting have changed so that the aliased and antialiased coordinate systems match. There used to be an offset of slightly less than half a pixel when doing sub-pixel rendering, in order to be consistent with the old X11 paint engine. The new behavior should be more predictable and give the same consistent rounding for images and pixmaps as for paths and rectangle filling. To get the old behavior, set the QPainter::Qt4CompatiblePainting 渲染提示。

Changes to QTouchEvent

• QTouchEvent::DeviceType and QTouchEvent::deviceType() are deprecated as QTouchDevice provides a better way to identify and access the device from which the events originate.
• The constructor now takes a QTouchDevice pointer instead of DeviceType 值。
• TouchPointStateMask and TouchPointPrimary are removed from the Qt::TouchPointStates 枚举。
• QTouchEvent::TouchPoint::isPrimary() is removed.

Qt Widgets 的变化

• QItemEditorFactory::createEditor () 和 QItemEditorFactory::valuePropertyName () signatures are changed to take arguments of type int 而不是 QVariant::Type .
• QInputContext is removed as related getter and setter functions in QWidget and QApplication are removed. Input contexts are now platform-specific.
• QInputDialog::getInteger () is deprecated. Use QInputDialog::getInt () 代替。
• The QStyleOption*V{2,3,4} classes are removed, and their members are merged with the respective base classes. The removed classes are left as typedefs for binary compatibility.
• QGraphicsItem and its derived classes can no longer pass a QGraphicsScene to the item's constructor. Construct the item without a scene and call QGraphicsScene::addItem () to add the item to the scene.
• QProxyModel is removed. Use QAbstractProxyModel and the related classes instead. A copy of QProxyModel is available in the Ui Helpers 存储库。

Changes to QApplication

• QApplication::setGraphicsSystem() is removed, because the introduction of QPA made it redundant.
• QApplication::commitData and QApplication::saveState virtual methods that were used for session management are removed. Connect to the QApplication::commitDataRequest and QApplication::saveStateRequest signals instead. Use QApplication::isSavingSession () 若 QWidget::closeEvent if your window needs to know whether it is being called during shutdown.

Changes to QStyle

• QStyle::standardIconImplementation() and QStyle::layoutSpacingImplementation() are removed, and the QStyle::standardIcon () 和 QStyle::layoutSpacing () functions are made pure virtual now. The removed functions were introduced in Qt 4 for binary compatibility reasons.
• QMotifStyle , QPlastiqueStyle , QCleanlooksStyle ，和 QCDEStyle are replaced with a new fusion style. If your application depends on any of these removed styles, you can either use the qtstyleplugins project to get these styles or update your application to use the new fusion style. For more details about this change, see https://blog.qt.io/blog/2012/10/30/cleaning-up-styles-in-qt5-and-adding-fusion/ .
• 下列 QStyle implementations have been made internal:
  • QFusionStyle
  • QGtkStyle
  • QMacStyle
  • QWindowsCEStyle
  • QWindowsMobileStyle
  • QWindowsStyle
  • QWindowsVistaStyle
  • QWindowsXPStyle

  Instead of creating instances or inheriting these classes directly, use:

  • QStyleFactory for creating instances of specific styles.
  • QProxyStyle for customizing existing style implementations.
  • QCommonStyle as a base for implementing full custom styles.

Changes to QHeaderView

The following functions are deprecated:

• void setMovable(bool movable) - Use QHeaderView::setSectionsMovable () 代替。
• bool isMovable() const - Use QHeaderView::sectionsMovable () 代替。
• void setClickable(bool clickable) - Use QHeaderView::setSectionsClickable () 代替。
• bool isClickable() const - Use QHeaderView::sectionsClickable () 代替。
• void setResizeMode(int logicalindex, ResizeMode mode) - Use QHeaderView::setSectionResizeMode () 代替。
• ResizeMode resizeMode(int logicalindex) const - Use QHeaderView::sectionResizeMode () 代替。

Changes to QAbstractItemView

• The derived classes now emit the clicked() signal on the left mouse click only, instead of all mouse clicks.
• 虚拟 QAbstractItemView::dataChanged () function signature now includes the roles that have changed. The signature is consistent with the dataChanged() signal in the model.

Changes to QColorDialog

• QColorDialog::customColor () now returns a QColor value instead of QRgb .
• QColorDialog::setCustomColor () 和 QColorDialog::setStandardColor () now need a QColor value as their second parameter instead of QRgb .

Changes to Qt WebKit

• The WebKit module in Qt is now split in two modules, webkit and webkitwidgets , in order to allow the dependency of the widgets module to be optional. The benefits will only be available once the QQuickWebView API is made public through C++ in a future version. The webkitwidgets module adds the webkit module automatically to the project, so in your application's project file, QT += webkit should now be modified to:

  QT += webkitwidgets
  					

• The same applies to the module include, #include <QtWebKit/QtWebKit> should be modified to:

  #include <QtWebKitWidgets/QtWebKitWidgets>
  					

• A consequence of the module split is that classes of the Qt WebKit API aren't all in the new module, so for a better compatibility of your application with both Qt4 and Qt5, #include <QtWebKit/QWebPage>, for example, should be included directly as:

  #include <QWebPage>
  					

  The include path will take care of selecting the right module.

• The qwebkitversion.h header has been renamed to q t webkitversion.h to match other Qt modules, and part of its contents has been moved to qwebkitglobal.h. #include <qwebkitversion.h> should be replaced with two includes:

  #include <qtwebkitversion.h>
  
  #include <qwebkitglobal.h>
  
  					

Qt Print Support 的变化

• The QPageSetupDialog::PageSetupDialogOption enum and the corresponding set and get functions, QPageSetupDialog::options() and QPageSetupDialog::setOptions() are removed.
• Support for printing PostScript files has been removed.
• The QAbstractPageSetupDialog class is removed. Use QPrintDialog 代替。
• The QPrintEngine::PrintEnginePropertyKey enum value PPK_SuppressSystemPrintStatus is removed.
• QPrinter no longer allows you to set an invalid printer name.

Qt Network 的变化

• The QSsl::TlsV1 enum value is renamed as QSsl::TlsV1_0 .
• The QHttp , QHttpHeader , QHttpResponseHeader ，和 QHttpRequestHeader classes are removed. Use QNetworkAccessManager 代替。
• The QFtp and QUrlInfo classes are no longer exported. Use QNetworkAccessManager instead. Programs that require raw FTP or HTTP streams can use the Qt FTP and Qt HTTP compatibility add-on modules that provide the QFtp and QHttp classes as they existed in Qt 4.
• QAbstractSocket::connectToHost () 和 QAbstractSocket::disconnectFromHost () are virtual now, and QAbstractSocket::connectToHostImplementation() and QAbstractSocket::disconnectFromHostImplementation() are removed.
• QTcpServer::incomingConnection () now takes arguments of type qintptr instead of an int .
• QNetworkConfiguration::bearerName() is removed. Use the bearerTypeName() 代替。

Changes to QSslCertificate

• QSslCertificate::subjectInfo () 和 QSslCertificate::issuerInfo () now return QStringList 而不是 QString . This change makes searching the required information a lot easier than scanning a long string.
• QSslCertificate::isValid () is deprecated. Use QSslCertificate::isBlacklisted () instead to avoid binary breaks in the future.
• QSslCertificate::alternateSubjectNames () is deprecated. Use QSslCertificate::subjectAlternativeNames () 代替。

Changes to Qt SQL

• QSqlQueryModel::indexInQuery () is virtual now.
• QSqlQueryModel::setQuery () emits fewer signals. The modelAboutToBeReset() and modelReset() signals are sufficient to inform views that they must re-interrogate the model.
• QSqlDriver::subscribeToNotification (), QSqlDriver::unsubscribeFromNotification (), QSqlDriver::subscribedToNotifications (), QSqlDriver::isIdentifierEscaped ()，和 QSqlDriver::stripDelimiters () are virtual now. The corresponding xxxImplementation functions are also removed as the subclasses of QSqlDriver can re-implement those directly.
• QSqlError now handles alphanumeric error codes that are used by QPSQL. The numeric codes are deprecated.

Changes to Qt Test

• The plain-text, XML and lightxml test output formats are updated to include test result for every row of test data in data-driven tests. In Qt4, only fails and skips were included for individual data rows without the passes information. This limitation prevented accurate test run and pass rates calculation.
• The QTRY_VERIFY and QTRY_COMPARE macros are now part of QTestLib . These macros were part of tests/shared/util.h earlier, but now they are part of the < QtTest / QtTest > header. In addition, QTRY_VERIFY_WITH_TIMEOUT and QTRY_COMPARE_WITH_TIMEOUT are provided to specify custom timeout values.
• The QTEST_NOOP_MAIN macro is removed. If a test appears to be inapplicable for a particular build at compile-time, it should be omitted either using the .pro file logic or call QSKIP 在 initTestCase() method to skip the entire test. If you're using the later approach, report a meaningful explanation in the test log.
• The DEPENDS_ON macro is removed as it misled some users to believe that they could make test functions depend on each other or impose an execution order on test functions.
• QTest::qt_snprintf() is removed. This was an internal test library function that was exposed in the public API due to its use in a public macro. Any calls to this function must be replaced with QByteArray::qsnprintf ().
• c{QTest::pixmapsAreEqual()} is removed. Comparison of QPixmap objects must be done using the QCOMPARE macro, which provides more informative output in the event of a failure.
• The "mode" parameter in QSKIP macro is removed. This parameter caused problems in test metrics calculation because of the SkipAll mode, which hid information about the skipped test data. Calling QSKIP in a test function now behaves like SkipSingle , which is skipping a non-data-driven test function or skipping only the current data row of a data-driven test function. Every skipped data row is now reported in the test log.
• qCompare() has been replaced by overloading. Code such as qCompare<QString>(l, r) no longer uses the QString -specific implementation and may fail to compile. We recommend that you replace specialization with overloading. Also, rather than pass explicit template arguments to qCompare , let the overload resolution pick the correct one, and cast arguments in case of ambiguous overloads (for example, qCompare(QString(l), r) ). The resulting code will continue to work against older QtTestlib versions.
• QTest::qWaitForWindowShown() 被替换采用 QTest::qWaitForWindowExposed ().

Qt OpenGL 的变化

Apart from the QGLWidget class, the Qt OpenGL module should not be used for new code. Instead, use the corresponding OpenGL classes in Qt GUI .

• QGLPixelBuffer is deprecated and implemented by using a hidden QGLWidget 和 QOpenGLFramebufferObject . For offscreen rendering to a texture, switch to using QOpenGLFramebufferObject directly to improve performance.
• The default major version of QGLFormat is changed to 2 to align it with QSurfaceFormat . Applications that want to use a different version, should explicitly request it using QGLFormat::setVersion ().
• QGLContext::generateFontDisplayLists() and QGLWidget::fontDisplayListBase() are removed.
• The listBase parameter is removed from QGLWidget::renderText () 函数。
• To ensure support on more platforms, stricter requirements have been introduced for doing threaded OpenGL . First, you must call QGLWidget::makeCurrent () at least once per each QGLWidget::swapBuffers () call, so that the platform has a chance to synchronize resizing the OpenGL surface. Second, before calling QGLWidget::makeCurrent () 或 QGLWidget::swapBuffers () in a separate thread, you must call QGLContext::moveToThread () to explicitly let Qt know in which thread a QGLContext is currently being used. You also need to make sure that the context is not current in the current thread before moving it to a different thread.

Changes to Qt Global

• qMacVersion() is removed. Use QSysInfo::macVersion () 或 QSysInfo::MacintoshVersion 代替。
• Qt::escape() is deprecated. Use QString::toHtmlEscaped () 代替。
• qIsDetached<> is removed, becauses it is irrelevant for multi-threaded applications. There is no replacement for this function.

Changes to Tools

• The qttest_p4.prf file is removed. Use CONFIG+=testcase and other flags instead.
• The -dwarf2 configure argument is removed. DWARF2 is always used on macOS now.
• Configure no longer calls qmake -recursive by default, because the subsequent build invokes qmake as needed. Use -fully-process to restore the old behavior.
• The lupdate CODECFORTR variable is deprecated, because source code written with Qt 5 is expected to use UTF-8 encoding.

相关话题

• Qt 5.5 中的新类和函数
• Qt 5.4 中的新类和函数
• Qt 5.3 中的新类和函数
• Qt 5.2 中的新类和函数
• Qt 5.1 中的新类和函数

内容

• Qt Core 的变化

• Changes to QAction

• Changes to QChar

• Changes to QCoreApplication

• Changes to QEvent

• Changes to QFile

• Changes to QFont

• Changes to QMetaType

• Changes to QMetaMethod

• Changes to QObject

• Changes to QVariant

• Changes to QAbstractEventDispatcher

• Changes to QDir

• Changes to QLocale

• Changes to QAbstractItemModel

• Changes to QString

• Changes to QDate, QTime, and QDateTime

• Changes to QTextCodec

• Changes to QUrl

• Qt Concurrent 的变化

• Qt GUI 的变化

• Changes to QAccessibleInterface

• Changes to QImage

• Changes to QPainter

• Changes to QTouchEvent

• Qt Widgets 的变化

• Changes to QApplication

• Changes to QStyle

• Changes to QHeaderView

• Changes to QAbstractItemView

• Changes to QColorDialog

• Changes to Qt WebKit

• Qt Print Support 的变化

• Qt Network 的变化

• Changes to QSslCertificate

• Changes to Qt SQL

• Changes to Qt Test

• Qt OpenGL 的变化

• Changes to Qt Global

• Changes to Tools

• 相关话题