Auf dieser Seite

StandardPaths QML Type

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

Import Statement: import QtCore
Since: Qt 6.2
Inherits:

QtObject

Methoden

Ausführliche Beschreibung

Der Singleton-Typ „StandardPaths“ stellt Methoden zur Abfrage der Standard-Systempfade bereit.

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

Siehe auch „ 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 in den Systempfaden, falls „ paths “ leer ist.

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.

Hinweis: Unter Windows werden die üblichen Dateiendungen für ausführbare Dateien (aus der Umgebungsvariable `PATHEXT`) automatisch angehängt. Der Aufruf `findExecutable("foo")` findet beispielsweise „ foo.exe “ oder „ foo.bat “, sofern vorhanden.

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

Wenn die angegebene „ executableName “ ein absoluter Pfad ist, 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 mit dem Namen „ 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()`.

list<url> standardLocations(StandardLocation type)

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

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

Siehe auch ` QStandardPaths::standardLocations()`.

url writableLocation(StandardLocation type)

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

Hinweis: Der zurückgegebene Speicherort existiert möglicherweise nicht; das heißt, er muss möglicherweise vom System oder vom Benutzer erstellt werden.

Siehe auch ` 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.