StandardPaths QML Type

Provides access to the standard system paths. More...

Import Statement:	import Qt.labs.platform 1.1
Since:	Qt 5.8
Inherits:	QtObject

• List of all members, including inherited members

Methods

• string displayName(StandardLocation type)
• url findExecutable(string executableName, list<string> paths)
• url locate(StandardLocation type, string fileName, LocateOptions options)
• list<url> locateAll(StandardLocation type, string fileName, LocateOptions options)
• void setTestModeEnabled(bool testMode)
• list<url> standardLocations(StandardLocation type)
• url writableLocation(StandardLocation type)

Detailed Description

The StandardPaths singleton type provides methods for querying the standard system paths. The standard paths are mostly useful in conjunction with the FileDialog and FolderDialog types.

FileDialog {
    folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)
}

Note: Types in Qt.labs modules are not guaranteed to remain compatible in future versions.

See also FileDialog, FolderDialog, and QStandardPaths.

Method Documentation

string displayName(StandardLocation type)

Returns a localized display name for the given location type or an empty QString if no relevant location can be found.

See also QStandardPaths::displayName().

url findExecutable(string executableName, list<string> paths)

Finds the executable named executableName in the specified paths, or the system paths if paths is empty.

On most operating systems the system path is determined by the PATH environment variable. The directories where to search for the executable can be set in the paths argument. To search in both your own paths and the system paths, call findExecutable twice, once with paths set and once with paths empty. Symlinks are not resolved in order to preserve behavior for the case of executables whose behavior depends on the name they are invoked with .

Note: On Windows, the usual executable extensions (from the PATHEXT environment variable) are automatically appended. For example, the findExecutable("foo") call finds foo.exe or foo.bat if present.

Returns the absolute file path to the executable, or an empty string if not found.

See also QStandardPaths::findExecutable().

url locate(StandardLocation type, string fileName, LocateOptions options)

Finds a file or directory called fileName in the standard locations for type.

The options flag lets you specify whether to look for files or directories. By default, this flag is set to LocateFile.

Returns the absolute path to the first file or directory found, otherwise returns an empty string.

See also QStandardPaths::locate().

list<url> locateAll(StandardLocation type, string fileName, LocateOptions options)

Finds all files or directories by the name, fileName, in the standard locations for type.

The options flag lets you specify whether to look for files or directories. By default, this flag is set to LocateFile.

Returns the list of all the files that were found.

See also QStandardPaths::locateAll().

void setTestModeEnabled(bool testMode)

If testMode is true, this enables a special "test mode" in QStandardPaths, which changes writable locations to point to test directories. This prevents auto tests from reading or writing to the current user's configuration.

It affects the locations into which test programs might write files: GenericDataLocation, AppDataLocation, ConfigLocation, GenericConfigLocation, AppConfigLocation, GenericCacheLocation, and CacheLocation. Other locations are not affected.

On Unix, XDG_DATA_HOME is set to ~/.qttest/share, XDG_CONFIG_HOME is set to ~/.qttest/config, and XDG_CACHE_HOME is set to ~/.qttest/cache.

On macOS, data goes to ~/.qttest/Application Support, cache goes to ~/.qttest/Cache, and config goes to ~/.qttest/Preferences.

On Windows, everything goes to a "qttest" directory under %APPDATA%.

See also QStandardPaths::setTestModeEnabled().

list<url> standardLocations(StandardLocation type)

Returns all the directories where files of type belong.

The list of directories is sorted from high to low priority, starting with writableLocation() if it can be determined. This list is empty if no locations for type are defined.

See also QStandardPaths::standardLocations().

url writableLocation(StandardLocation type)

Returns the directory where files of type should be written to, or an empty string if the location cannot be determined.

Note: The storage location returned may not exist; that is, it may need to be created by the system or the user.

See also QStandardPaths::writableLocation().