StandardPaths QML 类型

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

导入声明	import QtCore
自	Qt 6.2
继承	QtObject

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

方法

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)
list<url> standardLocations(StandardLocation type)
url writableLocation(StandardLocation type)

详细描述

StandardPaths 单例类型提供了查询标准系统路径的方法。

property url documentsFolder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)

另请参阅QStandardPaths.

方法文档

string displayName(StandardLocation type)

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

另请参阅QStandardPaths::displayName().

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

在指定的 paths 中查找名为 executableName 的可执行文件，或者在 paths 为空时查找系统路径。

在大多数操作系统上，系统路径由 PATH 环境变量确定。要设置要搜索可执行文件的目录，可以在 paths 参数中设置。要同时在您的路径和系统路径中搜索，请两次调用 findExecutable，一次设置路径，一次不设置路径。Symlinks 不会解析以保留对行为依赖于其调用名称的可执行文件的行为。

注意：在 Windows 上，通常的可执行文件扩展名（来自 PATHEXT 环境变量）将自动附加。例如，findExecutable("foo") 调用会找到 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)

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

选项 options 允许您指定查找文件或目录。默认情况下，此标志设置为 LocateFile。

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

另请参阅 QStandardPaths::locateAll().

list<url> standardLocations(StandardLocation type)

返回所有包含type类型文件的目录。

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

另请参阅 QStandardPaths::standardLocations().

url writableLocation(StandardLocation type)

返回应写入$i translate="no">type类型文件的目录，如果无法确定位置，则返回空字符串。

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

另请参阅 QStandardPaths::writableLocation().