このページでは

StandardPaths QML Type

標準のシステムパスへのアクセスを提供します。詳細...

Import Statement: import QtCore
Since: Qt 6.2
Inherits:

QtObject

メソッド

詳細な説明

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` を 2 回呼び出します。1 回目は `paths` を設定して、2 回目は `paths` を空にして呼び出します。呼び出し名によって動作が異なる実行ファイルの場合の挙動を維持するため、シンボリックリンクは解決されません。

注: 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)

type のファイルが書き込まれるべきディレクトリを返します。場所を特定できない場合は、空の文字列を返します。

注: 返される保存先は 存在しない場合があります。つまり、システムまたはユーザーによって作成する必要がある場合があります。

関連項目 :QStandardPaths::writableLocation()

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.