Qt 5.10 introduces many new features and improvements as well as bugfixes over the 5.9.x series. For more details, refer to the online documentation included in this distribution. The documentation is also available online: http://doc.qt.io/qt-5/index.html The Qt version 5.10 series is binary compatible with the 5.9.x series. Applications compiled for 5.9 will continue to run with 5.10. Some of the changes listed in this file include issue tracking numbers corresponding to tasks in the Qt Bug Tracker: https://bugreports.qt.io/ Each of these identifiers can be entered in the bug tracker to obtain more information about a particular change. **************************************************************************** * Important Behavior Changes * **************************************************************************** - [QTBUG-60857] The names of the roles returned by QSqlQueryModel::roleNames now only include a name for the Qt::DisplayRole. Previously all the roles names of QSqlQueryModel were returned. - QFileInfo on empty strings now behaves like the default-constructed QFileInfo. Notably, path() will now be the empty string too, instead of ".", which means absoluteFilePath() is no longer the current working directory. - QTemporaryFile: * rename() no longer attempts to do block copying, as that usually indicates a mistake in the user's code. Instead, either create the temporary file in the same directory as the new name to be, or use QSaveFile. * On Linux, QTemporaryFile will attempt to create unnamed temporary files. If that succeeds, open() will return true but exists() will be false. If you call fileName() or any function that calls it, QTemporaryFile will give the file a name, so most applications will not see a difference. - Windows: * [QTBUG-62662] On Windows, a drag & drop operation of local file URIs, like QListView items backed by a QFileSystemModel, will result in the attachment or opening of the files by the target application, instead of the creation of hyperlinks. **************************************************************************** * General Notes * **************************************************************************** Deprecation Notice ------------------ - Starting with Qt 5.10, IPv6 support is mandatory for all platforms. Systems without proper IPv6 support, such as the getaddrinfo() function or the proper socket address structures, will not be able to build QtNetwork anymore. - QSignalMapper is now marked as deprecated. Potentially Source-Incompatible Changes --------------------------------------- - QByteArray: * qbytearray.h no longer includes qstring.h. In particular, this means that in order to use QStringBuilder with QByteArray, you need to include both qbytearray.h and qstring.h now (or and , resp.). - QStaticText: * The QStaticText(const QString &) constructor is now explicit. Third-Party Code ---------------- - PCRE2 has been updated to version 10.30. - Replaced bundled libjpeg by libjpeg-turbo 1.5.2 - Improve documentation about Freetype 2 licenses. - Sqlite was updated to version 3.20.1 **************************************************************************** * Library * **************************************************************************** QtCore ------ - Added qHash(QStringView). - [QTBUG-37253] Added QMetaObject::invokeMethod() overloads for function pointers. - [QTBUG-41006] Added qEnvironmentVariable, which returns the value of an environment variable in a QString, while qgetenv continues to be used to return it in a QByteArray. For Unix, since most environment variables seem to contain path names, qEnvironmentVariable will do the same as QFile::decodeName, which means NFC/NFD conversion on Apple OSes. - [QTBUG-62915] qAddPostRoutine() and qRemovePostRoutine() are now thread-safe. - Containers: * Added an STL-like iterator to go through QHash/QMap returning both the key and the value of the element pointed to. That lets QHash/QMap interoperate better with stl's algorithms like std::set_union. - JSON: * QJsonArray, QJsonDocument, QJsonObject and QJsonValue now have move operations and a swap() member function. - Logging: * If you set QT_FATAL_WARNINGS to a number n > 1, Qt will stop the application on that n-th warning, instead of on the first. For the sake of compatibility with previous versions, if the variable is set to any non-empty and non-numeric value, Qt will understand it as "stop on first warning". - QByteArray: * Added shrink_to_fit() for compatibility with the Standard Library. This function does the same as squeeze(). - QChar: * Added constructors from char16_t and, on Windows, wchar_t. - QCoreApplication: * [QTBUG-57095] Calling QCoreApplication::translate() is now thread-safe. - QCryptographicHash: * [QTBUG-59770] In order to preserve compatibility with earlier versions of Qt, QCryptographicHash is now able to calculate Keccak message digests. Please see the release notes for Qt 5.9.2 for more details. - QDate/QTime/QDateTime: * Added toString() overloads taking the format as a QStringView. * [QTBUG-22833] Added support for parsing of time-zones. - QDebug: * Added streaming of QStringViews. - QFile: * [QTBUG-984] Added fileTime() and setFileTime(). - QFileInfo: * [QTBUG-984] Added fileTime(). * Deprecated created() because it could return one of three different file times depending on the OS and filesystem type, without the ability to determine which one is which. It is replaced by metadataChangeTime() and birthTime(). * Added QFileInfo::metadataChangeTime(), which returns the time the file's metadata was last changed, if it is known, and falling back to the same value as lastModified() otherwise. On Unix systems, this corresponds to the file's ctime. * Added QFileInfo::birthTime(), which returns the file's birth time if it is known, an invalid QDateTime otherwise. This function is supported on Windows and on some Unix systems. - QIODevice: * Added skip() method to improve performance in read operations. - QLatin1String: * Added isEmpty(), isNull(). * Added iterators, {c,}{r,}{begin,end}(). * Added chopped(), chop(), truncate(). * Added startsWith(), endsWith(). * Added a constructor taking two pointers, complementing the constructor that takes a pointer and a length. * Added trimmed() function. - QLocale: * Added toString(QDate/QTime/QDateTime) overloads taking the format string as a QStringView. * Added QLocale::formattedDataSize() for formatting quantities of bytes as kB, MB, GB etc. - QLockFile: * Fixed a bug that would cause QLockFile to mis-identify valid lock files as stale if the application name was set with QCoreApplication::setApplicationName(). - QMimeType: * Add Q_GADGET, so that QML applications can make use of QMimeType's properties and methods. - QObject: * [QTBUG-60339] Added connect() support for move-only function objects. - QProcess: * [QTBUG-2058][QTBUG-2284][QTBUG-37656][QTBUG-52405][QTBUG-57687] Added non-static QProcess::startDetached to support more features for detached processes. * [QTBUG-2284] Added the ability to set a custom process environment for detached processes. * [QTBUG-52405] Added the ability to specify native arguments for detached processes on Windows. * [QTBUG-2058][QTBUG-37656] Added support for standard channel redirection using setStandard{Input|Output|Error}File to QProcess::startDetached. - QSaveFile: * [QTBUG-47379] Saving to Alternate Data Streams on NTFS on Windows is now possible, but requires setDirectWriteFallback(true). - QSemaphore: * Added a new RAII class, QSemaphoreReleaser, to reliably perform release() calls. - QSettings: * [QTBUG-47379] Added setAtomicSyncRequired(), which allows one to use QSettings with config files in unwriteable directories or in Alternate Data Streams on NTFS on Windows. This used to work before Qt 5.4, but remains a non-default behavior due to the potential of data corruption. - QSortFilterProxyModel: * QSortFilterProxyModel now does not emit an unnecessary layoutChanged() following a model reset. - QStandardPaths: * On Windows, QStandardPaths now also looks into "/data/" for non-generic paths. - QString: * Added arg(QStringView), arg(QLatin1String) overloads. * Added shrink_to_fit(), for compatibility with the Standard Library. This function does the same as squeeze(). - QString/QStringRef: * Added startsWith(), endsWith() overloads taking QStringView. - QString/QStringRef/QByteArray: * Added chopped(n), a const version of chop(n). - QString/QStringRef/QByteArray/QLatin1String: * Added front() and back() for STL compatibility. - QStringBuilder: * Added support for (non-const) char*. - QStringList: * Added contains(QLatin1String) overload. - QStringRef: * trimmed() now returns an empty string-ref for an empty input. Before, it would return a null one. - QStringView: * New class, superseding const QString and QStringRef as function parameters, accepting a wide variety of UTF-16 string data sources, e.g. u"string", std::u16string{,_view}, and, on Windows, L"string", std::wstring{,_view} without converting to QString first. - QTemporaryDir: * The class now supports the "XXXXXX" replacement token anywhere in the template, not just at the end. This behavior is similar to what QTemporaryFile supports. - QTextCodec: * Added fromUnicode() and canEncode() overloads taking QStringView. - QTextEncoder: * Added fromUnicode() overload taking QStringView. - QThread: * Added the QThread::create() function. * An exception escaping from QThread::run() will now result in immediate and abnormal program termination. The same applies if an exception leaves a slot connected directly to the QThread::started() or QThread::finished() signals. - QUuid: * Added fromString(QStringView/QLatin1String). - QVariant: * QVariants containing pointers will now return true on isNull() if the contained pointer is null. - QVarLengthArray: * Added shrink_to_fit(), for compatibility with the Standard Library. - QVector: * Added shrink_to_fit(), for compatibility with the Standard Library. - QVersionNumber: * Added QStringView and QLatin1String overloads of fromString(). - QtGlobal: * Q_ASSERT() and Q_ASSERT_X() now always expand to expressions of type void that are usable in constexpr contexts. This makes them usable in both C++11 and C++14 constexpr functions and in comma expressions. QtGui ----- - [QTBUG-55981] Added support for rendering to QWindow via the Vulkan graphics API. - [QTBUG-55981] Added QVulkanWindow, a convenience subclass of QWindow. - Added support for the OpenGL ES 3.2 API in QOpenGLExtraFunctions - [QTBUG-50987] Added support for requesting OpenGL windows with sRGB-capable default framebuffers. While this is implicit on some platforms, QSurfaceFormat now has the necessary flags to request such windows in a cross-platform manner. - High DPI variants of 9-patch images can now be loaded using the following syntax: "foo@2x.9.png" - It's now possible to retrieve the screen at a given point via QGuiApplication::screenAt(). - Important Behvior Changes: * [QTBUG-56848][QTCREATORBUG-17683] Changed CSS line-height property with multiplier to follow CSS spec - Tablet support: * [QTBUG-44964] If the application attribute AA_CompressTabletEvents is set in addition to AA_CompressHighFrequencyEvents, even the QTabletEvents will be compressed (only on the X11 platform so far). AA_CompressHighFrequencyEvents does not enable compression of tablet events by itself, because paint applications typically need to process all possible tablet events in order to draw the smoothest curves. - QPA: * [QTBUG-57608] QWindowSystemInterfacePrivate::handleGeometryChange no longer takes the old geometry as an argument. - QImage: * QImages can now use more than 2GByte of pixel data. - QCursor: * Added equality operators. - QImageWriter: * Add QImageWriter::InvalidImageError to communicate invalid attempts to write a bad QImage (for instance, a null QImage). - QMovie: * Added lastError and lastErrorString accessors, as a convenience over connecting to the error() signal. - QWindow: * setMask() no longer requires the window to be created to have an effect; it can be set at any time. - Text: * [QTBUG-56728] Added QFont::PreferNoShaping style strategy to support improvements to performance at the expense of some cosmetic font features. - Windows: * [QTBUG-55967] Native menus have been implemented. * A native system tray icon is now available for SystemTrayIcon. QtNetwork --------- - [QTBUG-56102] QSslSocket can now use a temporary keychain on macOS. - Fixed a proxy-authentication issue, after a wrong password has been used, when supplying the right password. - HTTP/2: * [QTBUG-61397] In case of clear text HTTP/2 we now initiate a required protocol upgrade procedure instead of 'H2Direct' connection. - QHostInfo: * Added swap() and move operator. - QLocalServer: * [QTBUG-55043] Added a function to retrieve the socket descriptor. - QNetworkAccessManager: * [QTBUG-63075] Added support for HTTP status 308. - QNetworkInterface: * [QTBUG-51922] Changed allAddresses() to not include addresses found in inactive interfaces, matching the user expectations of this function. If those addresses are needed for some purpose, the application can call allInterfaces() and obtain the addresses in each interface. - QNetworkProxy: * [QTBUG-45495] Setting of network proxies is now supported on UWP. * [QTBUG-45495] UWP now supports proxies using SOCKS5. * The functions related to QNetworkConfiguration are deprecated. They've performed no action since Qt 5.0, so code using them can safely stop doing so. - QSslSocket: * [QTBUG-52905] Added OpenSSL 1.1 backend. QtSql ----- - QSqlError: * Added swap(). - SQLite: * Named placeholder can now be used. If compiling Qt by hand and using system libraries, this feature requires at least SQLite 3.3.11. * [QTBUG-18084] Added QSQLITE_ENABLE_REGEXP connect option for the SQLite backend. If set, a Qt based regexp() implementation is provided allowing use of REGEXP in SQL statements. QtTest ------ - [QTBUG-53381] Added keySequence() function. - QCOMPARE: * Can now be used for mixed-type comparisons. * Now outputs contents of QPair and std::pair on failure. * Now supports printing QStringViews in case of test failures. QtWidgets --------- - The windowsxp style is no longer available as a separate style, because it did not (and cannot) actually provide an XP-style appearance on currently supported Qt platforms. - Added AA_DisableWindowContextHelpButton attribute. Setting this attribute globally prevents the automatic "What's this" button on dialogs on Windows (WindowsContextHelpButtonHint). - [QTBUG-56860] Fixed widget losing focus after showing menu second time. - [QTBUG-47185][QTBUG-61280] QOpenGLWidget is now able to render and return its content via grabFramebuffer(), QWidget::grab() or QWidget::render() even when the widget has not been made visible. - [QTBUG-10907] When tabbing to a widget with focus proxy, focus will now be given to the proxy rather than just being ignored. - ItemViews: * Made it easier to drop above and below items. - QAbstractItemView/QTreeWidget/QTableWidget/QListWidget: * [QTBUG-61139] Added isPersistentEditorOpen(). - QDockWidget: * When QMainWindow::GrouppedDragging and QMainWindow::AllowNestedDocks are both enabled, floating dock widgets now have the ability to be dropped together side by side. * [QTBUG-63526] Fixed an issue in QDockWidgets where the widget would not resize despite showing a resize cursor. - QFusionStyle: * The default palette used by the platform-agnostic Fusion style has been desaturated. Previously the window background color, and other colors derived from it, were brown shades. Now these colors are neutral gray that fit better on any desktop. - QInputDialog: * [QTBUG-17547] Added setDoubleStep to enable changing of the step amount for getDouble(). - QLineEdit: * Added selectionEnd(), selectionLength(), complementing selectionStart(). - QOpenGLWidget: * [QTBUG-50987] Added support for specifying custom internal texture formats in QOpenGLWidget in order to make it possible to have the widget backed by an sRGB-capable framebuffer. - QSplashScreen: * All constructors now implicitly set Qt::FramelessWindowHint, not just the (pixmap, flags) one. - QWidget: * [QTBUG-10907] QWidget::setTabOrder() will now preserve the local tab order inside a widget if it has a focus proxy set to an inner child. - Styles: * Added SH_Widget_Animation_Duration style hint which supersedes SH_Widget_Animate, which is now deprecated. - Text: * Introduced tabStopDistance property in QTextOption, QTextEdit and QPlainTextEdit as replacement for the inconsistently named tabStop and tabStopWidth properties. QTextOption::tabStop, QTextEdit::tabStopWidth and QPlainTextEdit::tabStopWidth are now deprecated. **************************************************************************** * Platform-specific Changes * **************************************************************************** - [QTBUG-60268] Input context is now supported with the offscreen platform. Android ------- - QtLoader: Enabled loading shared libraries from /system/lib or a custom path specified with the android.app.system_libs_prefix metadata variable in AndroidManifest.xml. This supports deploying Qt apps as Android system apps. - [QTBUG-58060] Android dialogs now have more appropriate button layouts, with affirmative actions on the right. - [QTBUG-59175] QWidget::createWindowContainer() is now supported on Android for embedding OpenGL-based QWindows into widget UIs. iOS --- - [QTBUG-59403] Support added for using the input panel as a trackpad using two-finger swipe. - The minimum deployment target for applications is now iOS 10.0. Linux ----- - Qt uses the statx(2) system call for obtaining file information on kernels 4.12 and later. Some older container systems install system call protection rules that do not include this system call. If you experience problems running Qt applications inside containers (such as the report of a file not existing when it does), ensure the statx(2) is allowed in the container configuration. - Linux/XCB: * Added screen product information from EDID. - eglfs/KMS: * Screen modes, including current and preferred ones, are now listed. * Added screen product information from EDID. Windows ------- - Accessibility: * MinGW builds now support IAccessible2. - Fonts: * [QTBUG-62176] Some key fonts, such as Calibri, were being detected as bitmap fonts and not rendered correctly in Qt Quick. This has now been fixed. X11 --- - Native painting (instead of software rasterization) has been experimentally re-introduced. Enabled by the configure option -xcb-native-painting. - XInput device property changes are now detected at runtime (no application restart required). - [QTBUG-60513][QTBUG-29278][QTBUG-43768][QTBUG-18380] The _NET_WORKAREA atom is used for calculating QScreen::availableGeometry() only on systems with one monitor. In all other cases QScreen::availableGeometry() is equal to QScreen::geometry(). To restore the legacy behavior with untrustworthy values in QScreen::availableGeometry() set QT_RELY_ON_NET_WORKAREA_ATOM=1 in the environment. - The QT_XCB_NO_XI2_MOUSE environment variable is deprecated and will be removed in Qt 6. If your application relies on behavior set by QT_XCB_NO_XI2_MOUSE, it should be updated accordingly. - Pointer event delivery on X11 is now done starting from XInput version 2.0 (when available) instead of 2.2. XInput support can be disabled by setting QT_XCB_NO_XI2=1 in the environment; note that doing so will also disable tablet and touch support. **************************************************************************** * Tools * **************************************************************************** moc --- - moc now supports NOTIFY signals of parent classes in Q_PROPERTY qmake ----- - [QTBUG-1581] Introduced the variable OBJECTIVE_HEADERS. - [QTBUG-11117][nmake] Added support for precompiled header also for plain C files. - Added versionAtLeast() and versionAtMost() test functions. - If you use CONFIG+=qmltestcase with no SOURCES, 'make check' will now run qmltestrunner for you. - [Darwin] Added support for Info.plist in non-bundle apps and libs. uic --- - [QTBUG-51602] Added the no-stringliteral option, to be used for building shared objects which are meant to be unloadable. - Old images embedded in ui files, imported from Qt 3, are now ignored. uic will now behave consistently with Qt Designer - both will ignore them.