QStandardPaths Class
Die Klasse „QStandardPaths“ bietet Methoden für den Zugriff auf Standardpfade. Mehr...
| Header: | #include <QStandardPaths> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Öffentliche Typen
| enum | LocateOption { LocateFile, LocateDirectory } |
| flags | LocateOptions |
| enum | StandardLocation { DesktopLocation, DocumentsLocation, FontsLocation, ApplicationsLocation, MusicLocation, …, GenericStateLocation } |
Statische öffentliche Mitglieder
| QString | displayName(QStandardPaths::StandardLocation type) |
| QString | findExecutable(const QString &executableName, const QStringList &paths = QStringList()) |
| QString | locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile) |
| QStringList | locateAll(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile) |
| void | setTestModeEnabled(bool testMode) |
| QStringList | standardLocations(QStandardPaths::StandardLocation type) |
| QString | writableLocation(QStandardPaths::StandardLocation type) |
Ausführliche Beschreibung
Diese Klasse enthält Funktionen zur Abfrage von Standardpfaden im lokalen Dateisystem für gängige Aufgaben wie benutzerspezifische Verzeichnisse oder systemweite Konfigurationsverzeichnisse.
Dokumentation zum Mitgliedstyp
enum QStandardPaths::LocateOption
flags QStandardPaths::LocateOptions
Diese Enumeration beschreibt die verschiedenen Flags, die zur Steuerung des Verhaltens von QStandardPaths::locate und QStandardPaths::locateAll verwendet werden können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStandardPaths::LocateFile | 0x0 | Nur Dateien zurückgeben |
QStandardPaths::LocateDirectory | 0x1 | Gibt nur Verzeichnisse zurück |
Der Typ „LocateOptions“ ist ein typedef für QFlags<LocateOption>. Er speichert eine ODER-Kombination von LocateOption-Werten.
enum QStandardPaths::StandardLocation
Diese Enumeration beschreibt die verschiedenen Speicherorte, die mithilfe von Methoden wie „ QStandardPaths::writableLocation “, „ QStandardPaths::standardLocations “ und „ QStandardPaths::displayName “ abgefragt werden können.
QStandardPaths Jeder Speicherort wird anhand zweier unabhängiger Achsen beschrieben: App-Bereich (privat für die aufrufende Anwendung oder gemeinsam für mehrere Anwendungen) und Benutzerbereich (in den Verzeichnissen des aufrufenden Benutzers oder systemweit). Jeder der unten aufgeführten Enum-Werte gibt den App-Bereich an; die weiter unten aufgeführten Plattformtabellen zeigen den Benutzerbereich an.
Der Datenaustausch mit anderen Benutzern fällt nicht in den Geltungsbereich von „ QStandardPaths “.
Anwendungsbereich
Ein Speicherort ist entweder anwendungsspezifisch (nur für die aufrufende Anwendung zugänglich) oder generisch (gemeinsam für Anwendungen desselben Benutzers). Es ist davon auszugehen, dass anwendungsspezifische Speicherorte für andere Anwendungen nicht erreichbar sind, selbst wenn diese vom selben Benutzer ausgeführt werden.
Sandbox-Anwendungen
Bei Sandbox-Anwendungen auf Plattformen wie iOS, Android oder macOS können sogar generische Speicherorte im Sandbox-Container der Anwendung verortet sein (in den folgenden Tabellen als „<APPROOT> “ bezeichnet). In der Praxis hebt dies die Unterscheidung nach App-Umfang auf, sodass jeder Speicherort effektiv anwendungsspezifisch wird und die systemweiten, gemeinsam genutzten Verzeichnisse des Benutzers nur über vom System bereitgestellte Auswahldialoge erreichbar sind, zum Beispiel QFileDialog.
Benutzerbereich
Ein Speicherort ist entweder benutzerspezifisch (mit Stammverzeichnis im Home-Verzeichnis oder in den benutzerspezifischen Verzeichnissen des aufrufenden Benutzers) oder systemweit (vom Betriebssystem oder von Paketmanagern angelegt, für alle Benutzer gemeinsam genutzt und für Anwendungen in der Regel schreibgeschützt).
Der Aufruf von ` writableLocation()` gibt das Verzeichnis zurück, in das Dateien geschrieben werden sollen; dieses ist typischerweise benutzerspezifisch. Bei anwendungsspezifischen Speicherorten ist der Geltungsbereich auf die aufrufende Anwendung beschränkt.
Die Abfrage von ` standardLocations()` gibt zunächst den beschreibbaren Pfad zurück (sofern dieser ermittelt werden kann), gefolgt von null oder mehr zusätzlichen Speicherorten, darunter sowohl benutzerlokale als auch systemweite Ausweichspeicherorte. Die zusätzlichen Speicherorte werden von ` locate()` und ` locateAll()` verwendet, um vorhandene Dateien zu finden.
Sandbox-Anwendungen
Bei Anwendungen in einer Sandbox liegen systemweite Speicherorte in der Regel außerhalb des Sandbox-Containers der Anwendung und existieren aus Sicht der Anwendung möglicherweise gar nicht, geschweige denn, dass sie les- oder beschreibbar wären. Sie werden in den nachstehenden Plattformtabellen dennoch aufgeführt, um die Symmetrie zum Fall ohne Sandbox zu wahren und um Anwendungen abzudecken, denen über Berechtigungen oder benutzergesteuerte Auswahlfelder Zugriff gewährt wurde. Aufrufer sollten nicht davon ausgehen, dass jeder von ` standardLocations()` zurückgegebene Eintrag existiert oder zugänglich ist.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStandardPaths::DesktopLocation | 0 | Das Desktop-Verzeichnis des Benutzers. Auf Systemen ohne Desktop-Konzept entspricht dies „HomeLocation“. Generisch. |
QStandardPaths::DocumentsLocation | 1 | Verzeichnis, das Dokumentdateien enthält. Der zurückgegebene Pfad ist niemals leer. Generisch. |
QStandardPaths::FontsLocation | 2 | Verzeichnis, das Schriftarten enthält. Beachten Sie, dass die Installation von Schriftarten möglicherweise zusätzliche, plattformspezifische Schritte erfordert. Generisch. |
QStandardPaths::ApplicationsLocation | 3 | Verzeichnis, das Anwendungen enthält (entweder ausführbare Dateien, Anwendungsbündel oder Verknüpfungen zu diesen). Beachten Sie, dass die Installation von Anwendungen möglicherweise zusätzliche, plattformspezifische Schritte erfordert. Dateien, Ordner oder Verknüpfungen in diesem Verzeichnis sind plattformspezifisch. Generisch. |
QStandardPaths::MusicLocation | 4 | Verzeichnis, das Musik- oder andere Audiodateien enthält. Wenn kein solches Verzeichnis existiert, wird ein sinnvoller Ausweichort zum Speichern von Dokumenten zurückgegeben. Generisch. |
QStandardPaths::MoviesLocation | 5 | Verzeichnis, das Filme und Videos enthält. Wenn kein solches Verzeichnis existiert, wird ein sinnvoller Ausweichort für die Speicherung von Dokumenten zurückgegeben. Generisch. |
QStandardPaths::PicturesLocation | 6 | Verzeichnis, das Bilder oder Fotos enthält. Falls kein solches Verzeichnis existiert, wird ein sinnvoller Ausweichpfad zum Speichern von Dokumenten zurückgegeben. Generisch. |
QStandardPaths::TempLocation | 7 | Verzeichnis, in dem temporäre Dateien gespeichert werden können. Der zurückgegebene Wert kann anwendungsspezifisch sein, von anderen Anwendungen dieses Benutzers gemeinsam genutzt werden oder sogar systemweit gelten. Der zurückgegebene Pfad ist niemals leer. Variiert. |
QStandardPaths::HomeLocation | 8 | Das Home-Verzeichnis des Benutzers (entspricht „ QDir::homePath()“). Auf Unix-Systemen entspricht dies der Umgebungsvariable „HOME“. Der zurückgegebene Pfad ist niemals leer. Generisch. |
QStandardPaths::AppLocalDataLocation | 9 | Der lokale Datenpfad unter Windows. Auf allen anderen Plattformen entspricht er dem Wert von `AppDataLocation`. Anwendungsspezifisch. Dieser Enum-Wert wurde in Qt 5.4 hinzugefügt. |
QStandardPaths::CacheLocation | 10 | Verzeichnis, in das nicht essentielle (zwischengespeicherte) Daten geschrieben werden sollen. Der zurückgegebene Pfad ist niemals leer. Anwendungsspezifisch. |
QStandardPaths::GenericCacheLocation | 15 | Verzeichnis, in das nicht essentielle (zwischengespeicherte) Daten, die von mehreren Anwendungen gemeinsam genutzt werden, geschrieben werden sollen. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen gemeinsamen Cache kennt. Generisch. |
QStandardPaths::GenericDataLocation | 11 | Verzeichnis, in dem anwendungsübergreifend gemeinsam genutzte persistente Daten gespeichert werden können. Der zurückgegebene Pfad ist niemals leer. Generisch. |
QStandardPaths::RuntimeLocation | 12 | Verzeichnis, in das Laufzeit-Kommunikationsdateien geschrieben werden sollen, wie z. B. lokale Unix-Sockets. Der zurückgegebene Pfad kann auf einigen Systemen leer sein. Generisch. |
QStandardPaths::ConfigLocation | 13 | Verzeichnis, in das Konfigurationsdateien geschrieben werden sollen. Der zurückgegebene Pfad ist niemals leer. Kann generisch oder anwendungsspezifisch sein (siehe „AppConfigLocation“ und „GenericConfigLocation“ für explizite Varianten). Variiert. |
QStandardPaths::DownloadLocation | 14 | Verzeichnis für heruntergeladene Dateien. Wenn kein solches Verzeichnis existiert, wird ein sinnvoller Ausweichpfad zum Speichern von Dokumenten zurückgegeben. Generisch. |
QStandardPaths::GenericConfigLocation | 16 | Verzeichnis, in das Konfigurationsdateien geschrieben werden sollen, die von mehreren Anwendungen gemeinsam genutzt werden. Der zurückgegebene Pfad ist niemals leer. Generisch. |
QStandardPaths::AppDataLocation | 17 | Verzeichnis, in dem persistente Anwendungsdaten gespeichert werden können. Um einen Pfad zum Speichern von Daten zu erhalten, die mit anderen Anwendungen gemeinsam genutzt werden sollen, verwenden Sie `GenericDataLocation`. Der zurückgegebene Pfad ist niemals leer. Unter Windows wird hier der Roaming-Pfad zurückgegeben. Anwendungsspezifisch. Dieser Enum-Wert wurde in Qt 5.4 hinzugefügt. |
QStandardPaths::AppConfigLocation | 18 | Verzeichnis, in das Konfigurationsdateien geschrieben werden sollen. Der zurückgegebene Pfad ist niemals leer. Anwendungsspezifisch. Dieser Enum-Wert wurde in Qt 5.5 hinzugefügt. |
QStandardPaths::PublicShareLocation | 19 | Verzeichnis, in dem öffentlich freigegebene Dateien und Verzeichnisse gespeichert werden können. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen öffentlich freigegebenen Speicherort kennt. Generisch. Dieser Enum-Wert wurde in Qt 6.4 hinzugefügt. |
QStandardPaths::TemplatesLocation | 20 | Verzeichnis, in dem Vorlagendateien gespeichert werden können. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen Vorlagen-Speicherort kennt. Generisch. Dieser Enum-Wert wurde in Qt 6.4 hinzugefügt. |
QStandardPaths::StateLocation (since Qt 6.7) | 21 | Verzeichnis, in das Anwendungszustandsdateien geschrieben werden sollen. Der zurückgegebene Pfad ist niemals leer. Anwendungsspezifisch. |
QStandardPaths::GenericStateLocation (since Qt 6.7) | 22 | Verzeichnis, in dem anwendungsübergreifende Statusdatendateien geschrieben werden sollen. Der zurückgegebene Pfad ist niemals leer. Generisch. |
Die folgende Tabelle enthält Beispiele für Pfade auf verschiedenen Betriebssystemen. Der erste Pfad ist der beschreibbare Pfad (sofern nicht anders angegeben). Andere, gegebenenfalls vorhandene zusätzliche Pfade stellen nicht beschreibbare Speicherorte dar.
| Pfadtyp | macOS | Windows |
|---|---|---|
| Desktop-Speicherort | „~/Desktop“ | „C:/Benutzer/<BENUTZER>/Desktop“ |
| Speicherort „Dokumente“ | „~/Dokumente“ | "C:/Benutzer/<BENUTZER>/Dokumente" |
| Speicherort der Schriftarten | „~/Bibliothek/Schriftarten“, „/Bibliothek/Schriftarten“, „/System/Bibliothek/Schriftarten“ | „C:/Windows/Fonts“ (nicht beschreibbar) |
| Speicherort der Anwendungen | „~/Anwendungen“, „/Anwendungen“ | "C:/Benutzer/<BENUTZER>/AppData/Roaming/Microsoft/Windows/Startmenü/Programme" |
| Speicherort der Musik | „~/Musik“ | „C:/Benutzer/<BENUTZER>/Musik“ |
| Filme-Speicherort | "~/Filme" | „C:/Benutzer/<BENUTZER>/Videos“ |
| Speicherort der Bilder | "~/Bilder" | „C:/Benutzer/<BENUTZER>/Bilder“ |
| Speicherort für temporäre Dateien | vom Betriebssystem zufällig generiert | „C:/Benutzer/<BENUTZER>/AppData/Local/Temp“ |
| HomeLocation | "~" | „C:/Benutzer/<BENUTZER>“ |
| Speicherort der App-Lokaldaten | "~/Library/Application Support/<APPNAME>", "/Library/Application Support/<APPNAME>". "<APPDIR>/../Resources" | "C:/Benutzer/<BENUTZER>/AppData/Local/<ANWENDUNGSNAME>", "C:/ProgramData/<ANWENDUNGSNAME>", "<ANWENDUNGSVERZEICHNIS>", "<ANWENDUNGSVERZEICHNIS>/data", "<ANWENDUNGSVERZEICHNIS>/data/<ANWENDUNGSNAME>" |
| Cache-Speicherort | "~/Library/Caches/<APPNAME>", "/Library/Caches/<APPNAME>" | „C:/Benutzer/<BENUTZER>/AppData/Local/<APPNAME>/cache“ |
| Speicherort des Zustands | "~/Library/Preferences/<APPNAME>/State" | "C:/Benutzer/<USER>/AppData/Local/<APPNAME>/State", "C:/ProgramData/<APPNAME>/State" |
| GenericDataLocation | "~/Library/Application Support", "/Library/Application Support" | "C:/Benutzer/<BENUTZER>/AppData/Local", "C:/ProgramData", "<APPDIR>", "<APPDIR>/data" |
| RuntimeLocation | "~/Library/Application Support" | „C:/Benutzer/<USER>“ |
| Konfigurationsspeicherort | "~/Library/Preferences", "/Library/Preferences" | "C:/Benutzer/<BENUTZER>/AppData/Local/<ANWENDUNGSNAME>", "C:/ProgramData/<ANWENDUNGSNAME>" |
| GenericConfigLocation | "~/Library/Preferences", "/Library/Preferences" | "C:/Benutzer/<BENUTZER>/AppData/Local", "C:/ProgramData" |
| DownloadLocation | "~/Downloads" | "C:/Benutzer/<BENUTZER>/Downloads" |
| Generischer Cache-Speicherort | „~/Library/Caches“, „/Library/Caches“, „/System/Library/Caches“ | "C:/Benutzer/<BENUTZER>/AppData/Local/cache" |
| Generischer Speicherort für den Status | „~/Library/Preferences/State“ | „C:/Benutzer/<BENUTZER>/AppData/Local/State“, „C:/ProgramData/State“ |
| AppDataLocation | "~/Library/Application Support/<APPNAME>", "/Library/Application Support/<APPNAME>". "<APPDIR>/../Resources" | "C:/Benutzer/<BENUTZER>/AppData/Roaming/<APPNAME>", "C:/ProgramData/<APPNAME>", "<APPDIR>", "<APPDIR>/data", "<APPDIR>/data/<APPNAME>" |
| AppConfigLocation | "~/Library/Preferences/<APPNAME>", "/Library/Preferences/<APPNAME>" | "C:/Benutzer/<BENUTZER>/AppData/Local/<APPNAME>", "C:/ProgramData/<APPNAME>" |
| PublicShareLocation | "~/Public" | "C:/Benutzer/Public" |
| Speicherort der Vorlagen | wird nicht unterstützt | „C:/Benutzer/<BENUTZER>/AppData/Roaming/Microsoft/Windows/Templates“ |
Hinweis: Unter macOS leitet das Betriebssystem, wenn die Anwendung in einer Sandbox ausgeführt wird, das Home-Verzeichnis des Benutzers transparent in einen anwendungsspezifischen Container unter ~/Library/Containers/<BUNDLE-ID>/Data um. Die obige macOS-Tabelle gilt weiterhin, wobei ~ für Einträge, die im Home-Verzeichnis des Benutzers liegen, effektiv zu <APPROOT> aufgelöst wird. Systemweite Fallbacks wie /Library/..., /System/Library/... und <APPDIR>/../Resources sind der Vollständigkeit halber aufgeführt, sind jedoch in der Regel ohne explizite Berechtigungen nicht erreichbar.
| Pfadtyp | Linux und andere UNIX-Betriebssysteme |
|---|---|
| DesktopLocation | „~/Desktop“ |
| Speicherort für Dokumente | „~/Dokumente“ |
| Speicherort der Schriftarten | „~/.fonts“, „~/.local/share/fonts“, „/usr/local/share/fonts“, „/usr/share/fonts“ |
| Speicherort der Anwendungen | „~/.local/share/applications“, „/usr/local/share/applications“, „/usr/share/applications“ |
| Musik-Speicherort | „~/Music“ |
| Speicherort für Filme | „~/Videos“ |
| Speicherort für Bilder | „~/Bilder“ |
| Temporärer Speicherort | "/tmp" |
| Home-Verzeichnis | "~" |
| Speicherort der lokalen App-Daten | „~/.local/share/<APPNAME>“, „/usr/local/share/<APPNAME>“, „/usr/share/<APPNAME>“ |
| Cache-Speicherort | "~/.cache/<APPNAME>" |
| StateLocation | „~/.local/state/<APPNAME>“ |
| Speicherort für allgemeine Daten | "~/.local/share", "/usr/local/share", "/usr/share" |
| Laufzeit-Speicherort | "/run/user/<USER>" |
| Konfigurationsspeicherort | „~/.config“, „/etc/xdg“ |
| Generischer Konfigurationsspeicherort | „~/.config“, „/etc/xdg“ |
| Download-Speicherort | „~/Downloads“ |
| Generischer Cache-Speicherort | „~/.cache“ |
| Allgemeiner Speicherort für den Status | „~/.local/state“ |
| AppDataLocation | „~/.local/share/<APPNAME>“, „/usr/local/share/<APPNAME>“, „/usr/share/<APPNAME>“ |
| AppConfigLocation | „~/.config/<APPNAME>“, „/etc/xdg/<APPNAME>“ |
| Speicherort für öffentliche Freigaben | "~/Public" |
| Speicherort der Vorlagen | "~/Templates" |
| Pfadtyp | Android | iOS |
|---|---|---|
| Desktop-Speicherort | "<APPROOT>/files" | „<APPROOT>/Documents/Desktop“ |
| Speicherort „Dokumente“ | "<USER>/Dokumente" [*], "<USER>/<APPNAME>/Dokumente" | "<APPROOT>/Dokumente" |
| Speicherort der Schriftarten | "/system/fonts" (nicht beschreibbar) | „<APPROOT>/Library/Fonts“ |
| Speicherort der Anwendungen | wird nicht unterstützt (Verzeichnis nicht lesbar) | wird nicht unterstützt |
| Musik-Speicherort | „<USER>/Music“ [*], „<USER>/<APPNAME>/Music“ | „<APPROOT>/Dokumente/Musik“ |
| Filme-Speicherort | „<USER>/Filme“ [*], „<USER>/<APPNAME>/Filme“ | „<APPROOT>/Dokumente/Filme“ |
| Speicherort für Bilder | "<USER>/Bilder" [*], "<USER>/<APPNAME>/Bilder" | „<APPROOT>/Dokumente/Bilder“, „assets-library://“ |
| TempLocation | "<APPROOT>/cache" | „<APPROOT>/tmp“ |
| HomeLocation | "<APPROOT>/files" | systemdefiniert |
| AppLocalDataLocation | "<APPROOT>/files", "<USER>/<APPNAME>/files" | "<APPROOT>/Library/Application Support" |
| CacheLocation | "<APPROOT>/cache", "<USER>/<APPNAME>/cache" | "<APPROOT>/Library/Caches" |
| StateLocation | "<APPROOT>/files/state" | "<APPROOT>/Library/Preferences/<APPNAME>/State" |
| Generischer Speicherort für Zustandsdaten (es gibt gemeinsam genutzte Zustandsdaten) | "<APPROOT>/files/state" | "<APPROOT>/Library/Preferences/State" |
| Generischer Speicherort für Daten | "<USER>" [*] oder "<USER>/<APPNAME>/files" | "<APPROOT>/Library/Application Support" |
| RuntimeLocation | "<APPROOT>/cache" | „<APPROOT>/Library/Application Support“ |
| Konfigurationsspeicherort | "<APPROOT>/files/settings" | "<APPROOT>/Library/Preferences" |
| GenericConfigLocation | "<APPROOT>/files/settings" (es gibt keine gemeinsamen Einstellungen) | "<APPROOT>/Library/Preferences" |
| DownloadLocation | "<USER>/Downloads" [*], "<USER>/<APPNAME>/Downloads" | "<APPROOT>/Dokumente/Downloads" |
| Generischer Cache-Speicherort | "<APPROOT>/cache" (es gibt keinen gemeinsamen Cache) | „<APPROOT>/Library/Caches“ |
| AppDataLocation | "<APPROOT>/files", "<USER>/<APPNAME>/files" | "<APPROOT>/Library/Application Support" |
| AppConfigLocation | "<APPROOT>/files/settings" | "<APPROOT>/Library/Preferences/<APPNAME>" |
| PublicShareLocation | wird nicht unterstützt | "<APPROOT>/Public" |
| TemplatesLocation | wird nicht unterstützt | nicht unterstützt |
In der obigen Tabelle ist „ <APPNAME> “ in der Regel der Name der Organisation, der Name der Anwendung oder beides, oder ein bei der Paketierung generierter eindeutiger Name. Ebenso ist „<APPROOT>“ der Speicherort, an dem diese Anwendung installiert ist (häufig eine Sandbox). „<APPDIR>“ ist das Verzeichnis, das die ausführbare Datei der Anwendung enthält.
Man sollte sich nicht auf die oben genannten Pfade verlassen, da sie sich je nach Betriebssystemkonfiguration, Ländereinstellung oder in zukünftigen Qt-Versionen ändern können.
Hinweis: Unter Android werden Anwendungen, die offene Dateien auf dem externen Speicher (<USER>-Speicherorte) haben, beendet, wenn der externe Speicher ausgehängt wird.
Hinweis: Unter Android 6.0 (API 23) oder höher muss die Berechtigung „WRITE_EXTERNAL_STORAGE“ zur Laufzeit angefordert werden, wenn „ QStandardPaths::writableLocation “ oder „ QStandardPaths::standardLocations “ verwendet werden.
Hinweis: Unter Android ist für das Lesen/Schreiben in „GenericDataLocation“ die Erteilung der Berechtigungen „READ_EXTERNAL_STORAGE“ bzw. „WRITE_EXTERNAL_STORAGE“ erforderlich.
Hinweis: [ *] Unter Android 11 und höher sind öffentliche Verzeichnisse im Scoped-Storage-Modus nicht mehr direkt zugänglich. Daher werden Pfade der Form "<USER>/DirName" nicht zurückgegeben. Stattdessen können Sie QFileDialog verwenden, das das Storage Access Framework (SAF) nutzt, um auf solche Verzeichnisse zuzugreifen.
Hinweis: Wenn Sieunter iOS „ QStandardPaths::standardLocations(QStandardPaths::PicturesLocation).last() “ als Argument an „ QFileDialog::setDirectory()“ übergeben, wird ein nativer Bildauswahldialog für den Zugriff auf das Fotoalbum des Benutzers verwendet. Der zurückgegebene Dateiname kann mithilfe von „ QFile “ und den zugehörigen APIs geladen werden. Diese Funktion wurde in Qt 5.5 hinzugefügt.
Siehe auch writableLocation(), standardLocations(), displayName(), locate() und locateAll().
Dokumentation zu den Mitgliedsfunktionen
[static] QString QStandardPaths::displayName(QStandardPaths::StandardLocation type)
Gibt einen lokalisierten Anzeigenamen für den angegebenen Standort type zurück oder ein leeres QString, falls kein passender Standort gefunden werden kann.
[static] QString QStandardPaths::findExecutable(const QString &executableName, const QStringList &paths = QStringList())
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.
Ist die angegebene „ executableName “ ein absoluter Pfad, der auf eine ausführbare Datei verweist, wird deren bereinigter Pfad zurückgegeben.
[static] QString QStandardPaths::locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
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.
[static] QStringList QStandardPaths::locateAll(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
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.
[static] void QStandardPaths::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.
[static] QStringList QStandardPaths::standardLocations(QStandardPaths::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 ` writableLocation()`.
[static] QString QStandardPaths::writableLocation(QStandardPaths::StandardLocation type)
Gibt das Verzeichnis zurück, in das die 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 noch nicht; das heißt, er muss möglicherweise vom System oder vom Benutzer erstellt werden.
© 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.
