Provides access to the standard system paths. 更多...
| import 语句： | import Qt.labs.platform |
| 继承： | QtObject |
Use QtCore::StandardPaths instead.
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 类型。
FileDialog { folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation) }
注意： Types in Qt.labs modules are not guaranteed to remain compatible in future versions.
另请参阅 QtCore::StandardPaths , FileDialog , FolderDialog ，和 QStandardPaths .
|
string displayName ( StandardLocation type ) |
返回本地化显示名为给定位置 type 或空 QString 若找不到相关位置。
另请参阅 QStandardPaths::displayName ().
|
url findExecutable ( string executableName , list < string > paths ) |
Finds the executable named executableName 以指定 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.
注意：
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
若存在。
Returns the absolute file path to the executable, or an empty string if not found.
If the given \n executableName is an absolute path pointing to an executable its clean path is returned.
另请参阅 QStandardPaths::findExecutable ().
|
url locate ( StandardLocation type , string fileName , LocateOptions options ) |
查找的文件 (或目录) 称为 fileName 在标准位置对于 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.
另请参阅 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
.
返回找到的所有文件的列表。
另请参阅 QStandardPaths::locateAll ().
|
void setTestModeEnabled ( bool testMode ) |
若
testMode
is
true
，这启用特殊 "测试模式" 在
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
，和
CacheLocation
. Other locations are not affected.
在 Unix，
XDG_DATA_HOME
被设为
~/.qttest/share
,
XDG_CONFIG_HOME
被设为
~/.qttest/config
，和
XDG_CACHE_HOME
被设为
~/.qttest/cache
.
在 macOS，数据转到
~/.qttest/Application Support
，缓存转到
~/.qttest/Cache
，和配置转到
~/.qttest/Preferences
.
On Windows, everything goes to a "qttest" directory under
%APPDATA%
.
另请参阅 QStandardPaths::setTestModeEnabled ().
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.
另请参阅 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.
注意： The storage location returned may not exist; that is, it may need to be created by the system or the user.
另请参阅 QStandardPaths::writableLocation ().
