StandardPaths QML 类型

提供对标准系统路径的访问。更多信息...

导入语句	import Qt.labs.platform
继承	QtObject
状态	已弃用自 6.4

此类型自 Qt.labs.platform 6.4 已弃用。我们强烈建议不要在新代码中使用它。

所有成员的列表，包括继承的成员

方法

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)

详细描述

请使用 QtCore::StandardPaths。

StandardPaths 单例类型提供查询标准系统路径的方法。标准路径通常与FileDialog和FolderDialog类型结合使用。

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

注意：Qt.labs 模块中的类型在未来的版本中不保证兼容。

另请参阅：QtCore::StandardPaths、FileDialog、FolderDialog和QStandardPaths。

方法文档

string displayName(StandardLocation type)

返回给定位置 type 的本地化显示名称，如果找不到相关位置则返回空的 QString。

另请参阅：QStandardPaths::displayName()。

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

在指定的 paths 中查找名为 executableName 的可执行文件，如果 paths 为空，则在系统路径中查找。

在大多数操作系统上，系统路径由PATH环境变量确定。可以在路径参数中设置搜索可执行文件的目录。要同时搜索您的路径和系统路径，请调用两次findExecutable，一次设置路径，一次清除路径。为了保持依赖于调用名称的特定可执行文件的行为，不解析符号链接。

注意：在Windows上，通常会自动追加通常的可执行文件扩展名（来自foo.exe或foo.bat。

返回可执行文件的绝对文件路径，如果未找到则返回空字符串。

如果给定的executableName是到可执行文件的绝对路径，则返回它的清洁路径。

另请参阅QStandardPaths::findExecutable。

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

在type的标准位置中查找名为fileName的文件或目录。

options标志让您指定是要查找文件还是目录。默认情况下，此标志设置为LocateFile。

返回找到的第一个文件或目录的绝对路径，否则返回空字符串。

另请参阅QStandardPaths::locate。

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

通过名称fileName在type的标准位置中查找所有文件或目录。

options标志让您指定是要查找文件还是目录。默认情况下，此标志设置为LocateFile。

返回找到的所有文件的列表。

另请参阅QStandardPaths::locateAll。

void setTestModeEnabled(bool testMode)

如果testMode为true，则此操作在QStandardPaths中启用特殊“测试模式”，将可写位置更改为指向测试目录。这可以防止自动测试从当前用户的配置中读取或写入。

它影响测试程序可能写入文件的目录：GenericDataLocation、AppDataLocation、ConfigLocation、GenericConfigLocation、AppConfigLocation、StateLocation、GenericStateLocation、GenericCacheLocation和CacheLocation。其他位置不受影响。

在Unix上，XDG_DATA_HOME设置为~/.qttest/share，XDG_CONFIG_HOME设置为~/.qttest/config，XDG_STATE_HOME设置为~/.qttest/state，而且XDG_CACHE_HOME设置为~/.qttest/cache。

在macOS上，数据保存在~/.qttest/Application Support，缓存保存在~/.qttest/Cache，而配置保存在~/.qttest/Preferences。

在Windows上，所有内容都保存在%APPDATA%下的“qttest”目录中。

另请参阅QStandardPaths::setTestModeEnabled。

list<url> standardLocations(StandardLocation type)

返回属于type类型的所有目录。

目录列表按优先级从高到低排序，如果可以确定则从 writableLocation() 开始。如果没有为类型定义位置，此列表为空。

另请参阅 QStandardPaths::standardLocations。

url writableLocation(StandardLocation type)

返回应将 type 类型的文件写入的目录，如果无法确定位置则返回空字符串。

注意： 返回的存储位置可能不存在；也就是说，可能需要由系统或用户创建。

另请参阅 QStandardPaths::writableLocation。