Obsolete Members for QDesktopServices | Qt GUI 5.6

Qt 5.6 | Qt GUI | C++ Classes | QDesktopServices

Qt 5.6.2 Reference Documentation

# Obsolete Members for QDesktopServices

The following members of class QDesktopServices are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

## Public Types

`(obsolete)` enum | StandardLocation { DesktopLocation, DocumentsLocation, FontsLocation, ApplicationsLocation, ..., CacheLocation }

## Static Public Members

`(obsolete)` QString | displayName(StandardLocation type)
`(obsolete)` QString | storageLocation(StandardLocation type)

## Member Type Documentation

### enum QDesktopServices::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.

Constant | Value | Description
--- | --- | ---
`QDesktopServices::DesktopLocation` | `0` | Returns the user's desktop directory.
`QDesktopServices::DocumentsLocation` | `1` | Returns the user's document.
`QDesktopServices::FontsLocation` | `2` | Returns the user's fonts.
`QDesktopServices::ApplicationsLocation` | `3` | Returns the user's applications.
`QDesktopServices::MusicLocation` | `4` | Returns the users music.
`QDesktopServices::MoviesLocation` | `5` | Returns the user's movies.
`QDesktopServices::PicturesLocation` | `6` | Returns the user's pictures.
`QDesktopServices::TempLocation` | `7` | Returns the system's temporary directory.
`QDesktopServices::HomeLocation` | `8` | Returns the user's home directory.
`QDesktopServices::DataLocation` | `9` | Returns a directory location where persistent application data can be stored. QCoreApplication::applicationName and QCoreApplication::organizationName should work on all platforms.
`QDesktopServices::CacheLocation` | `10` | Returns a directory location where user-specific non-essential (cached) data should be written.

This enum was introduced or modified in Qt 4.4.

See also storageLocation() and displayName().

## Member Function Documentation

### `[static]` QString QDesktopServices::displayName(StandardLocation type)

Use QStandardPaths::displayName()

### `[static]` QString QDesktopServices::storageLocation(StandardLocation type)

Use QStandardPaths::writableLocation()

Note: when porting QDesktopServices::DataLocation to QStandardPaths::DataLocation, a different path will be returned.

`QDesktopServices::DataLocation` was `GenericDataLocation + "/data/organization/application"`, while QStandardPaths::DataLocation is `GenericDataLocation + "/organization/application"`.

Also note that `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

      QDesktopServices::storageLocation(QDesktopServices::DataLocation)

with

      QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) +
      "/data/organization/application"

(assuming an organization name and an application name were set).