Doc: porting from QDesktopServices::DataLocation to QStandardPaths

Change-Id: Ifd96db46cc8d0170b136a9e3154ed37ebe6ad830
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
Reviewed-by: Giuseppe D'Angelo <giuseppe.dangelo@kdab.com>
This commit is contained in:
David Faure 2013-07-11 13:25:38 +02:00 committed by The Qt Project
parent 03285044a0
commit be8974633c

View File

@ -254,7 +254,7 @@ void QDesktopServices::unsetUrlHandler(const QString &scheme)
\enum QDesktopServices::StandardLocation
\since 4.4
\obsolete
Use QStandardPaths::StandardLocation
Use QStandardPaths::StandardLocation (see storageLocation() for porting notes)
This enum describes the different locations that can be queried by
QDesktopServices::storageLocation and QDesktopServices::displayName.
@ -282,6 +282,26 @@ void QDesktopServices::unsetUrlHandler(const QString &scheme)
\fn QString QDesktopServices::storageLocation(StandardLocation type)
\obsolete
Use QStandardPaths::writableLocation()
\note when porting QDesktopServices::DataLocation to QStandardPaths::DataLocation,
a different path will be returned.
\c{QDesktopServices::DataLocation} was \c{GenericDataLocation + "/data/organization/application"},
while QStandardPaths::DataLocation is \c{GenericDataLocation + "/organization/application"}.
Also note that \c{application} could be empty in Qt 4, if QCoreApplication::setApplicationName()
wasn't called, while in Qt 5 it defaults to the name of the executable.
Therefore, if you still need to access the Qt 4 path (for example for data migration to Qt 5), replace
\code
QDesktopServices::storageLocation(QDesktopServices::DataLocation)
\endcode
with
\code
QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) +
"/data/organization/application"
\endcode
(assuming an organization name and an application name were set).
*/
/*!