QStandardPaths Class
Die Klasse QStandardPaths bietet Methoden für den Zugriff auf Standardpfade. Mehr...
| Kopfzeile: | #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) |
Detaillierte Beschreibung
Diese Klasse enthält Funktionen zur Abfrage von Standardverzeichnissen im lokalen Dateisystem für allgemeine Aufgaben wie benutzerspezifische Verzeichnisse oder systemweite Konfigurationsverzeichnisse.
Dokumentation der Mitgliedstypen
enum QStandardPaths::LocateOption
flags QStandardPaths::LocateOptions
Diese Aufzählung 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 | nur Verzeichnisse zurückgeben |
Der Typ LocateOptions ist ein Typedef für QFlags<LocateOption>. Er speichert eine ODER-Kombination von LocateOption-Werten.
enum QStandardPaths::StandardLocation
Dieses Enum beschreibt die verschiedenen Standorte, die mit Methoden wie QStandardPaths::writableLocation, QStandardPaths::standardLocations und QStandardPaths::displayName abgefragt werden können.
Einige der Werte in dieser Aufzählung stellen eine Benutzerkonfiguration dar. Solche Enum-Werte geben in verschiedenen Anwendungen die gleichen Pfade zurück, so dass sie für die gemeinsame Nutzung von Daten mit anderen Anwendungen verwendet werden können. Andere Werte sind spezifisch für diese Anwendung. Jeder Enum-Wert in der folgenden Tabelle beschreibt, ob er anwendungsspezifisch oder allgemein ist.
Bei anwendungsspezifischen Verzeichnissen sollte davon ausgegangen werden, dass sie für andere Anwendungen unerreichbar sind. Daher können dort abgelegte Dateien von anderen Anwendungen nicht gelesen werden, selbst wenn sie vom selben Benutzer ausgeführt werden. Bei allgemeinen Verzeichnissen hingegen sollte davon ausgegangen werden, dass sie für alle von diesem Benutzer ausgeführten Anwendungen zugänglich sind, aber immer noch als unerreichbar für Anwendungen anderer Benutzer angesehen werden.
Der Datenaustausch mit anderen Benutzern fällt nicht in den Anwendungsbereich von QStandardPaths.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStandardPaths::DesktopLocation | 0 | Gibt das Desktop-Verzeichnis des Benutzers zurück. Dies ist ein allgemeiner Wert. Auf Systemen, die kein Konzept eines Desktops haben, entspricht dies QStandardPaths::HomeLocation. |
QStandardPaths::DocumentsLocation | 1 | Gibt das Verzeichnis mit den Benutzerdokumenten zurück. Dies ist ein allgemeiner Wert. Der zurückgegebene Pfad ist nie leer. |
QStandardPaths::FontsLocation | 2 | Gibt das Verzeichnis zurück, das die Schriftarten des Benutzers enthält. Dies ist ein allgemeiner Wert. Beachten Sie, dass die Installation von Schriftarten zusätzliche, plattformspezifische Operationen erfordern kann. |
QStandardPaths::ApplicationsLocation | 3 | Gibt das Verzeichnis zurück, das die Benutzeranwendungen enthält (entweder ausführbare Dateien, Anwendungspakete oder Verknüpfungen zu diesen). Dies ist ein allgemeiner Wert. Beachten Sie, dass für die Installation von Anwendungen zusätzliche, plattformspezifische Vorgänge erforderlich sein können. Dateien, Ordner oder Verknüpfungen in diesem Verzeichnis sind plattformspezifisch. |
QStandardPaths::MusicLocation | 4 | Gibt das Verzeichnis mit den Musik- oder anderen Audiodateien des Benutzers zurück. Dies ist ein allgemeiner Wert. Wenn kein spezielles Verzeichnis für Musikdateien existiert, wird ein sinnvoller Fallback für die Speicherung von Benutzerdokumenten zurückgegeben. |
QStandardPaths::MoviesLocation | 5 | Gibt das Verzeichnis zurück, das die Filme und Videos des Benutzers enthält. Dies ist ein allgemeiner Wert. Wenn kein spezifisches Verzeichnis für Filmdateien existiert, wird ein sinnvoller Fallback für die Speicherung von Benutzerdokumenten zurückgegeben. |
QStandardPaths::PicturesLocation | 6 | Gibt das Verzeichnis zurück, das die Bilder oder Fotos des Benutzers enthält. Dies ist ein allgemeiner Wert. Wenn kein spezifisches Verzeichnis für Bilddateien vorhanden ist, wird ein sinnvoller Fallback für die Speicherung von Benutzerdokumenten zurückgegeben. |
QStandardPaths::TempLocation | 7 | Gibt ein Verzeichnis zurück, in dem temporäre Dateien gespeichert werden können. Der zurückgegebene Wert kann anwendungsspezifisch, gemeinsam mit anderen Anwendungen für diesen Benutzer oder sogar systemweit sein. Der zurückgegebene Pfad ist nie leer. |
QStandardPaths::HomeLocation | 8 | Gibt das Heimatverzeichnis des Benutzers zurück (wie QDir::homePath()). Auf Unix-Systemen ist dies gleich der Umgebungsvariablen HOME. Dieser Wert kann allgemein oder anwendungsspezifisch sein, aber der zurückgegebene Pfad ist nie leer. |
QStandardPaths::AppLocalDataLocation | 9 | Gibt auf dem Windows-Betriebssystem den Pfad zu den lokalen Einstellungen zurück. Auf allen anderen Plattformen wird der gleiche Wert wie AppDataLocation zurückgegeben. Dieser Enum-Wert wurde in Qt 5.4 hinzugefügt. |
QStandardPaths::CacheLocation | 10 | Gibt ein Verzeichnis zurück, in das benutzerspezifische, nicht-essentielle (gecachte) Daten geschrieben werden sollen. Dies ist ein anwendungsspezifisches Verzeichnis. Der zurückgegebene Pfad ist niemals leer. |
QStandardPaths::GenericCacheLocation | 15 | Gibt ein Verzeichnis zurück, in das benutzerspezifische, nicht-essentielle (zwischengespeicherte) Daten geschrieben werden sollen, die von allen Anwendungen gemeinsam genutzt werden. Dies ist ein allgemeiner Wert. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen gemeinsamen Cache hat. |
QStandardPaths::GenericDataLocation | 11 | Gibt einen Verzeichnisspeicherort zurück, in dem persistente Daten, die von verschiedenen Anwendungen gemeinsam genutzt werden, gespeichert werden können. Dies ist ein allgemeiner Wert. Der zurückgegebene Pfad ist nie leer. |
QStandardPaths::RuntimeLocation | 12 | Gibt einen Verzeichnisspeicherort zurück, in den Laufzeit-Kommunikationsdateien geschrieben werden sollen, wie z.B. lokale Unix-Sockets. Dies ist ein allgemeiner Wert. Der zurückgegebene Pfad kann auf manchen Systemen leer sein. |
QStandardPaths::ConfigLocation | 13 | Gibt ein Verzeichnis zurück, in das benutzerspezifische Konfigurationsdateien geschrieben werden sollen. Dies kann entweder ein allgemeiner Wert oder anwendungsspezifisch sein, und der zurückgegebene Pfad ist nie leer. |
QStandardPaths::DownloadLocation | 14 | Gibt ein Verzeichnis für die heruntergeladenen Dateien des Benutzers zurück. Dies ist ein allgemeiner Wert. Wenn kein spezifisches Verzeichnis für Downloads vorhanden ist, wird ein sinnvoller Fallback für die Speicherung von Benutzerdokumenten zurückgegeben. |
QStandardPaths::GenericConfigLocation | 16 | Gibt ein Verzeichnis zurück, in das benutzerspezifische Konfigurationsdateien, die von mehreren Anwendungen gemeinsam genutzt werden, geschrieben werden sollen. Dies ist ein allgemeiner Wert und der zurückgegebene Pfad ist nie leer. |
QStandardPaths::AppDataLocation | 17 | Gibt ein Verzeichnis zurück, in dem persistente Anwendungsdaten gespeichert werden können. Dies ist ein anwendungsspezifisches Verzeichnis. Um einen Pfad zum Speichern von Daten zu erhalten, die mit anderen Anwendungen geteilt werden sollen, verwenden Sie QStandardPaths::GenericDataLocation. Der zurückgegebene Pfad ist niemals leer. Auf dem Windows-Betriebssystem wird der Roaming-Pfad zurückgegeben. Dieser Enum-Wert wurde in Qt 5.4 hinzugefügt. |
QStandardPaths::AppConfigLocation | 18 | Gibt ein Verzeichnis zurück, in das benutzerspezifische Konfigurationsdateien geschrieben werden sollen. Dies ist ein anwendungsspezifisches Verzeichnis, und der zurückgegebene Pfad ist nie leer. Dieser Enum-Wert wurde in Qt 5.5 hinzugefügt. |
QStandardPaths::PublicShareLocation | 19 | Gibt ein Verzeichnis zurück, in dem benutzerspezifische öffentlich freigegebene Dateien und Verzeichnisse gespeichert werden können. Dies ist ein generischer Wert. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen öffentlich freigegebenen Ort hat. Dieser Enum-Wert wurde in Qt 6.4 hinzugefügt. |
QStandardPaths::TemplatesLocation | 20 | Gibt ein Verzeichnis zurück in dem benutzerspezifische Vorlagendateien gespeichert werden können. Dies ist ein generischer Wert. Beachten Sie, dass der zurückgegebene Pfad leer sein kann, wenn das System kein Konzept für einen Speicherort für Vorlagen hat. Dieser Enum-Wert wurde in Qt 6.4 hinzugefügt. |
QStandardPaths::StateLocation (since Qt 6.7) | 21 | Gibt ein Verzeichnis zurück, in das benutzerspezifische Dateien mit Anwendungsstatus geschrieben werden sollen. Dies ist ein anwendungsspezifisches Verzeichnis, und der zurückgegebene Pfad ist niemals leer. |
QStandardPaths::GenericStateLocation (since Qt 6.7) | 22 | Gibt ein Verzeichnis zurück, in das anwendungsübergreifende Zustandsdatendateien geschrieben werden sollen. Dieser Wert kann allgemein oder anwendungsspezifisch sein, aber der zurückgegebene Pfad ist nie leer. |
Die folgende Tabelle enthält Beispiele für Pfade auf verschiedenen Betriebssystemen. Der erste Pfad ist der beschreibbare Pfad (sofern nicht anders angegeben). Andere, zusätzliche Pfade, falls vorhanden, stellen nicht beschreibbare Speicherorte dar.
| Pfad-Typ | macOS | Windows |
|---|---|---|
| DesktopLocation | "~/Desktop" | "C:/Benutzer/<BENUTZER>/Desktop" |
| DokumenteSpeicherort | "~/Dokumente" | "C:/Benutzer/<BENUTZER>/Dokumente" |
| SchriftartenSpeicherort | "/System/Library/Fonts" (nicht beschreibbar) | "C:/Windows/Schriftarten" (nicht beschreibbar) |
| AnwendungenSpeicherort | "/Applications" (nicht beschreibbar) | "C:/Benutzer/<BENUTZER>/AppData/Roaming/Microsoft/Windows/Startmenü/Programme" |
| MusikStandort | "~/Musik" | "C:/Benutzer/<BENUTZER>/Musik" |
| FilmeSpeicherort | "~/Filme" | "C:/Benutzer/<BENUTZER>/Videos" |
| BilderStandort | "~/Bilder" | "C:/Benutzer/<BENUTZER>/Bilder" |
| TempLocation | zufällig vom Betriebssystem generiert | "C:/Benutzer/<BENUTZER>/AppData/Local/Temp" |
| Heimatort | "~" | "C:/Benutzer/<BENUTZER>" |
| AppLocalDataLocation | "~/Library/Application Support/<APPNAME>", "/Library/Application Support/<APPNAME>". "<APPDIR>/../Ressourcen" | "C:/Benutzer/<USER>/AppData/Local/<APPNAME>", "C:/ProgramData/<APPNAME>", "<APPDIR>", "<APPDIR>/data", "<APPDIR>/data/<APPNAME>" |
| CacheLocation | "~/Library/Caches/<APPNAME>", "/Library/Caches/<APPNAME>" | "C:/Benutzer/<BENUTZER>/AppData/Local/<APPNAME>/cache" |
| StateLocation | "~/Library/Preferences/<APPNAME>/State" | "C:/Benutzer/<BENUTZER>/AppData/Local/<APPNAME>/State", "C:/ProgramData/<APPNAME>/State" |
| GenericDataLocation | "~/Library/Application Support", "/Library/Application Support" | "C:/Benutzer/<USER>/AppData/Local", "C:/ProgramData", "<APPDIR>", "<APPDIR>/data" |
| RuntimeLocation | "~/Library/Application Support" | "C:/Benutzer/<BENUTZER>" |
| ConfigLocation | "~/Library/Preferences" | "C:/Benutzer/<BENUTZER>/AppData/Local/<APPNAME>", "C:/ProgramData/<APPNAME>" |
| GenericConfigLocation | "~/Library/Preferences" | "C:/Benutzer/<BENUTZER>/AppData/Local", "C:/ProgramData" |
| HerunterladenSpeicherort | "~/Downloads" | "C:/Benutzer/<BENUTZER>/Downloads" |
| GenericCacheLocation | "~/Library/Caches", "/Library/Caches" | "C:/Benutzer/<BENUTZER>/AppData/Local/cache" |
| GenericStateLocation | "~/Library/Preferences/State" | "C:/Benutzer/<BENUTZER>/AppData/Local/State", "C:/ProgramData/State" |
| AppDataLocation | "~/Library/Application Support/<APPNAME>", "/Library/Application Support/<APPNAME>". "<APPDIR>/../Ressourcen" | "C:/Benutzer/<USER>/AppData/Roaming/<APPNAME>", "C:/ProgramData/<APPNAME>", "<APPDIR>", "<APPDIR>/data", "<APPDIR>/data/<APPNAME>" |
| AppConfigLocation | "~/Library/Preferences/<APPNAME>" | "C:/Benutzer/<USER>/AppData/Local/<APPNAME>", "C:/ProgramData/<APPNAME>" |
| PublicShareLocation | "~/Public" | "C:/Benutzer/Öffentlich" |
| VorlagenStandort | "~/Vorlagen" | "C:/Benutzer/<BENUTZER>/AppData/Roaming/Microsoft/Windows/Templates" |
| Pfad-Typ | Linux und andere UNIX-Betriebssysteme |
|---|---|
| DesktopStandort | "~/Desktop" |
| DokumenteSpeicherort | "~/Dokumente" |
| SchriftartenSpeicherort | "~/.fonts", "~/.local/share/fonts", "/usr/local/share/fonts", "/usr/share/fonts" |
| ApplicationsLocation | "~/.local/share/applications", "/usr/local/share/applications", "/usr/share/applications" |
| MusikStandort | "~/Musik" |
| FilmeOrt | "~/Videos" |
| BilderStandort | "~/Bilder" |
| TempOrt | "/tmp" |
| Heimatort | "~" |
| AppLocalDataLocation | "~/.local/share/<APPNAME>", "/usr/local/share/<APPNAME>", "/usr/share/<APPNAME>" |
| CacheLocation | "~/.cache/<APPNAME>" |
| StateLocation | "~/.local/state/<APPNAME>" |
| GenericDataLocation " | "~/.local/share", "/usr/local/share", "/usr/share" |
| RuntimeLocation | "/run/user/<USER>" |
| ConfigLocation | "~/.config", "/etc/xdg" |
| GenericConfigLocation | "~/.config", "/etc/xdg" |
| DownloadLocation | "~/Downloads" |
| GenericCacheLocation | "~/.cache" |
| GenericStateLocation | "~/.local/state" |
| AppDataLocation | "~/.local/share/<APPNAME>", "/usr/local/share/<APPNAME>", "/usr/share/<APPNAME>" |
| AppConfigLocation | "~/.config/<APPNAME>", "/etc/xdg/<APPNAME>" |
| PublicShareLocation | "~/Öffentlich" |
| VorlagenStandort | "~/Templates" |
| Pfad-Typ | Android | iOS |
|---|---|---|
| DesktopSpeicherort | "<APPROOT>/Dateien" | "<APPROOT>/Dokumente/Desktop" |
| DokumenteSpeicherort | "<USER>/Documents" [*], "<USER>/<APPNAME>/Documents" | "<APPROOT>/Dokumente" |
| SchriftartenSpeicherort | "/system/fonts" (nicht beschreibbar) | "<APPROOT>/Library/Fonts" |
| AnwendungenSpeicherort | nicht unterstützt (Verzeichnis nicht lesbar) | nicht unterstützt |
| MusikSpeicherort | "<BENUTZER>/Musik" [*], "<BENUTZER>/<APPNAME>/Musik" | "<APPROOT>/Dokumente/Musik" |
| FilmeSpeicherort | "<BENUTZER>/Filme" [*], "<BENUTZER>/<APPNAME>/Filme" | "<APPROOT>/Dokumente/Filme" |
| PicturesLocation | "<BENUTZER>/Bilder" [*], "<BENUTZER>/<APPNAME>/Bilder" | "<APPROOT>/Dokumente/Bilder", "assets-library://" |
| TempLocation | "<APPROOT>/cache" | "<APPROOT>/tmp" |
| Heimatort | "<APPROOT>/Dateien" | System definiert |
| AppLocalDataLocation | "<APPROOT>/files", "<USER>/<APPNAME>/files" | "<APPROOT>/Library/Anwendungsunterstützung" |
| CacheSpeicherort | "<APPROOT>/cache", "<USER>/<APPNAME>/cache" | "<APPROOT>/Bibliothek/Caches" |
| StateLocation | "<APPROOT>/files/state" | |
| GenericStateLocation (es gibt einen gemeinsamen Status) | "<APPROOT>/files/state | |
| GenericDataLocation | "<USER>" [*] oder "<USER>/<APPNAME>/files" | "<APPROOT>/Library/Anwendungsunterstützung" |
| RuntimeLocation | "<APPROOT>/Cache" | nicht unterstützt |
| ConfigLocation | "<APPROOT>/Dateien/Einstellungen" | "<APPROOT>/Library/Preferences" |
| GenericConfigLocation | "<APPROOT>/Dateien/Einstellungen" (es gibt keine gemeinsamen Einstellungen) | "<APPROOT>/Library/Preferences" (Bibliothek/Einstellungen) |
| DownloadSpeicherort | "<BENUTZER>/Downloads" [*], "<BENUTZER>/<APPNAME>/Downloads" | "<APPROOT>/Dokumente/Downloads" |
| GenericCacheLocation | "<APPROOT>/cache" (es gibt keinen gemeinsamen Cache) | "<APPROOT>/Library/Caches" |
| AppDataLocation | "<APPROOT>/Dateien", "<USER>/<APPNAME>/Dateien" | "<APPROOT>/Library/Anwendungsunterstützung" |
| AppConfigLocation | "<APPROOT>/Dateien/Einstellungen" | "<APPROOT>/Library/Preferences/<APPNAME>" |
| PublicShareLocation | nicht unterstützt | nicht unterstützt |
| VorlagenStandort | 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 eindeutiger Name, der bei der Paketierung generiert wird. In ähnlicher Weise ist <APPROOT> der Ort, an dem diese Anwendung installiert ist (oft eine Sandbox). <APPDIR> ist das Verzeichnis, das die ausführbare Datei der Anwendung enthält.
Auf die obigen Pfade sollte man sich nicht verlassen, da sie sich je nach Betriebssystemkonfiguration oder Gebietsschema ändern können oder in zukünftigen Qt-Versionen geändert werden können.
Hinweis: Unter Android werden Anwendungen mit offenen Dateien auf dem externen Speicher (<USER> Speicherorte) 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 wird.
Hinweis: Unter Android muss für das Lesen/Schreiben von GenericDataLocation die Berechtigung READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE erteilt werden.
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) für den Zugriff auf solche Verzeichnisse nutzt.
Hinweis: Unter iOS, wenn Sie 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 mit QFile und verwandten APIs geladen werden. Diese Funktion wurde in Qt 5.5 hinzugefügt.
Siehe auch writableLocation(), standardLocations(), displayName(), locate(), und locateAll().
Dokumentation der Mitgliedsfunktionen
[static] QString QStandardPaths::displayName(QStandardPaths::StandardLocation type)
Gibt einen lokalisierten Anzeigenamen für den angegebenen Ort type oder einen leeren QString zurück, wenn kein entsprechender Ort gefunden werden kann.
[static] QString QStandardPaths::findExecutable(const QString &executableName, const QStringList &paths = QStringList())
Findet die ausführbare Datei mit dem Namen executableName im angegebenen paths oder im Systempfad, wenn paths leer ist.
Auf den meisten Betriebssystemen wird der Systempfad durch die Umgebungsvariable PATH bestimmt. Die Verzeichnisse, in denen nach der ausführbaren Datei gesucht werden soll, können mit dem Argument paths angegeben werden. Um sowohl in Ihren eigenen Pfaden als auch in den Systempfaden zu suchen, rufen Sie findExecutable zweimal auf, einmal mit gesetzten Pfaden und einmal mit leeren Pfaden. Symlinks werden nicht aufgelöst, um das Verhalten von ausführbaren Dateien zu erhalten, deren Verhalten vom Namen abhängt, mit dem sie aufgerufen werden.
Hinweis: Unter Windows werden die üblichen ausführbaren Erweiterungen (aus der Umgebungsvariablen PATHEXT) automatisch angehängt. Der Aufruf findExecutable("foo") findet zum Beispiel foo.exe oder foo.bat, falls vorhanden.
Gibt den absoluten Dateipfad zur ausführbaren Datei zurück oder eine leere Zeichenkette, falls nicht gefunden.
Wenn der angegebene executableName ein absoluter Pfad ist, der auf eine ausführbare Datei verweist, wird ihr reiner Pfad zurückgegeben.
[static] QString QStandardPaths::locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
Findet eine Datei oder ein Verzeichnis mit dem Namen fileName an den Standardspeicherorten für type.
Mit dem Flag options können Sie angeben, ob Sie nach Dateien oder Verzeichnissen suchen möchten. Standardmäßig ist dieses Flag auf LocateFile gesetzt.
Gibt den absoluten Pfad zur ersten gefundenen Datei oder zum ersten gefundenen Verzeichnis zurück, andernfalls eine leere Zeichenfolge.
[static] QStringList QStandardPaths::locateAll(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
Findet alle Dateien oder Verzeichnisse mit dem Namen fileName an den Standardspeicherorten für type.
Mit dem Flag options können Sie angeben, ob Sie nach Dateien oder Verzeichnissen suchen möchten. Standardmäßig ist dieses Flag auf LocateFile gesetzt.
Gibt die Liste aller gefundenen Dateien zurück.
[static] void QStandardPaths::setTestModeEnabled(bool testMode)
Wenn testMode gleich true ist, wird ein spezieller "Testmodus" in QStandardPaths aktiviert, der beschreibbare Speicherorte so ändert, dass sie auf Testverzeichnisse verweisen. Dadurch wird verhindert, dass Autotests die Konfiguration des aktuellen Benutzers lesen oder in sie schreiben.
Es betrifft die Verzeichnisse, in die Testprogramme Dateien schreiben können: GenericDataLocation, AppDataLocation, ConfigLocation, GenericConfigLocation, AppConfigLocation, StateLocation, GenericStateLocation, GenericCacheLocation und CacheLocation. Andere Speicherorte sind nicht betroffen.
Unter Unix wird XDG_DATA_HOME auf ~/.qttest/share, XDG_CONFIG_HOME auf ~/.qttest/config, XDG_STATE_HOME auf ~/.qttest/state und XDG_CACHE_HOME auf ~/.qttest/cache gesetzt.
Unter macOS werden die Daten auf ~/.qttest/Application Support, der Cache auf ~/.qttest/Cache und die Konfiguration auf ~/.qttest/Preferences abgelegt.
Unter Windows wird alles in einem "qttest"-Verzeichnis unter %APPDATA% abgelegt.
[static] QStringList QStandardPaths::standardLocations(QStandardPaths::StandardLocation type)
Gibt alle Verzeichnisse zurück, zu denen die Dateien von type gehören.
Die Liste der Verzeichnisse ist von hoher zu niedriger Priorität sortiert, beginnend mit writableLocation(), falls diese ermittelt werden kann. Diese Liste ist leer, wenn keine Verzeichnisse 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 einen leeren String, wenn der Speicherort nicht ermittelt werden kann.
Hinweis: Der zurückgegebene Speicherort existiert möglicherweise nicht, d. h. er muss möglicherweise vom System oder vom Benutzer erstellt werden.
© 2025 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.
