Back to Qt.io
Contact Us Blog Download Qt

StandardPaths QML Type

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

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Status: Deprecated since 6.4

この型はQt.labs.platform 6.4から非推奨となりました。新しいコードでは使用しないことを強くお勧めします。

メソッド

詳しい説明

代わりにQtCore::StandardPathsを使用してください。

StandardPathsシングルトン型は、標準のシステムパスを問い合わせるためのメソッドを提供します。標準パスは、FileDialog やFolderDialog 型と組み合わせて使用すると便利です。

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

注意: Qt.labモジュールの型は、将来のバージョンでも互換性が保たれることは保証されていません。

QtCore::StandardPaths,FileDialog,FolderDialog,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を設定し、もう1回は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()も参照してください 。


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()も参照してください 。


ここに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。