StandardPaths QML Type

Bietet Zugriff auf die Standard-Systempfade. Mehr...

Dieser Typ ist seit Qt Labs Platform 6.4 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Methoden

• 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)

Ausführliche Beschreibung

Verwenden Sie stattdessen QtCore::StandardPaths.

Der Singleton-Typ `StandardPaths` bietet Methoden zur Abfrage der Standard-Systempfade. Die Standardpfade sind vor allem in Verbindung mit den Typen ` FileDialog ` und ` FolderDialog ` nützlich.

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

Siehe auch „ QtCore::StandardPaths“ , „ FileDialog “, „ FolderDialog “ und „ QStandardPaths “.

Methodendokumentation

string displayName(StandardLocation type)

Gibt einen lokalisierten Anzeigenamen für den angegebenen Standort type zurück oder einen leeren QString, falls kein passender Standort gefunden werden kann.

Siehe auch QStandardPaths::displayName().

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

Sucht nach der ausführbaren Datei mit dem Namen „ executableName “ im angegebenen Verzeichnis „ paths “ oder, falls „ paths “ leer ist, in den Systempfaden.

Auf den meisten Betriebssystemen wird der Systempfad durch die Umgebungsvariable „ PATH “ festgelegt. Die Verzeichnisse, in denen nach der ausführbaren Datei gesucht werden soll, können im Argument „paths“ festgelegt werden. Um sowohl in Ihren eigenen Pfaden als auch in den Systempfaden zu suchen, rufen Sie `findExecutable` zweimal auf: einmal mit festgelegten Pfaden und einmal mit leeren Pfaden. Symlinks werden nicht aufgelöst, um das Verhalten für den Fall beizubehalten, dass das Verhalten von ausführbaren Dateien von dem Namen abhängt, mit dem sie aufgerufen werden.

Gibt den absoluten Dateipfad zur ausführbaren Datei zurück oder eine leere Zeichenkette, falls diese nicht gefunden wird.

Ist die angegebene „ executableName “ ein absoluter Pfad, der auf eine ausführbare Datei verweist, wird deren bereinigter Pfad zurückgegeben.

Siehe auch QStandardPaths::findExecutable().

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

Sucht an den Standardorten nach einer Datei oder einem Verzeichnis namens „ fileName “ für „ type “.

Mit dem Flag „ options “ können Sie festlegen, ob nach Dateien oder Verzeichnissen gesucht werden soll. Standardmäßig ist dieses Flag auf „ LocateFile “ gesetzt.

Gibt den absoluten Pfad zur ersten gefundenen Datei oder zum ersten gefundenen Verzeichnis zurück, andernfalls wird eine leere Zeichenkette zurückgegeben.

Siehe auch ` QStandardPaths::locate()`.

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

Sucht alle Dateien oder Verzeichnisse mit dem Namen „ fileName “ an den Standardorten für „ type “.

Mit dem Flag „ options “ können Sie festlegen, ob nach Dateien oder Verzeichnissen gesucht werden soll. Standardmäßig ist dieses Flag auf „ LocateFile “ gesetzt.

Gibt die Liste aller gefundenen Dateien zurück.

Siehe auch ` QStandardPaths::locateAll()`.

void setTestModeEnabled(bool testMode)

Wenn testMode auf true gesetzt ist, wird ein spezieller „Testmodus“ unter QStandardPaths aktiviert, der die beschreibbaren Speicherorte so ändert, dass sie auf Testverzeichnisse verweisen. Dadurch wird verhindert, dass automatisierte Tests die Konfiguration des aktuellen Benutzers lesen oder darin schreiben.

Dies betrifft die Verzeichnisse, in die Testprogramme möglicherweise Dateien schreiben: GenericDataLocation, AppDataLocation, ConfigLocation, GenericConfigLocation, AppConfigLocation, StateLocation, GenericStateLocation, GenericCacheLocation und CacheLocation. Andere Verzeichnisse sind davon nicht betroffen.

Unter Unix ist XDG_DATA_HOME auf ~/.qttest/share gesetzt, XDG_CONFIG_HOME auf ~/.qttest/config, XDG_STATE_HOME auf ~/.qttest/state und XDG_CACHE_HOME auf ~/.qttest/cache.

Unter macOS werden die Daten unter ~/.qttest/Application Support gespeichert, der Cache unter ~/.qttest/Cache und die Konfiguration unter ~/.qttest/Preferences.

Unter Windows werden alle Daten in ein Verzeichnis „qttest“ unter %APPDATA% gespeichert.

Siehe auch QStandardPaths::setTestModeEnabled().

list<url> standardLocations(StandardLocation type)

Gibt alle Verzeichnisse zurück, in denen sich Dateien vom Typ „ type “ befinden.

Die Liste der Verzeichnisse ist nach Priorität sortiert, beginnend mit „ writableLocation “ (), sofern diese ermittelt werden kann. Diese Liste ist leer, wenn keine Speicherorte für den Typ definiert sind.

Siehe auch „ QStandardPaths::standardLocations“ ().

url writableLocation(StandardLocation type)

Gibt das Verzeichnis zurück, in das die Dateien von „ type “ geschrieben werden sollen, oder eine leere Zeichenkette, wenn der Speicherort nicht ermittelt werden kann.

Siehe auch ` QStandardPaths::writableLocation()`.