StandardPaths QML Type

Permet d'accéder aux chemins d'accès standard du système. Plus...

Ce type est obsolète depuis Qt Labs Platform 6.4. Il est fortement déconseillé de l'utiliser dans un nouveau code.

• Liste de tous les membres, y compris les membres hérités

Méthodes

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

Description détaillée

Utilisez QtCore::StandardPaths à la place.

Le singleton StandardPaths fournit des méthodes pour interroger les chemins d'accès standard du système. Les chemins standards sont principalement utiles en conjonction avec les types FileDialog et FolderDialog.

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

Voir aussi QtCore::StandardPaths, FileDialog, FolderDialog, et QStandardPaths.

Documentation des méthodes

string displayName(StandardLocation type)

Renvoie un nom d'affichage localisé pour l'emplacement donné type ou un QString vide si aucun emplacement pertinent ne peut être trouvé.

Voir aussi QStandardPaths::displayName().

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

Recherche l'exécutable nommé executableName dans le répertoire paths spécifié, ou dans le chemin d'accès au système si paths est vide.

Sur la plupart des systèmes d'exploitation, le chemin d'accès au système est déterminé par la variable d'environnement PATH. Les répertoires dans lesquels l'exécutable doit être recherché peuvent être définis dans l'argument paths. Pour rechercher à la fois dans vos propres chemins et dans les chemins du système, appelez findExecutable deux fois, une fois avec chemins définis et une fois avec chemins vides. Les liens symboliques ne sont pas résolus afin de préserver le comportement des exécutables dont le comportement dépend du nom avec lequel ils sont invoqués.

Renvoie le chemin d'accès absolu à l'exécutable, ou une chaîne vide s'il n'est pas trouvé.

Si executableName est un chemin d'accès absolu à un exécutable, son chemin d'accès propre est renvoyé.

Voir aussi QStandardPaths::findExecutable().

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

Recherche un fichier ou un répertoire appelé fileName dans les emplacements standard de type.

L'option options vous permet de spécifier si vous devez rechercher des fichiers ou des répertoires. Par défaut, cet indicateur est défini sur LocateFile.

Renvoie le chemin d'accès absolu au premier fichier ou répertoire trouvé, sinon renvoie une chaîne vide.

Voir aussi QStandardPaths::locate().

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

Recherche tous les fichiers ou répertoires portant le nom fileName, dans les emplacements standard de type.

L'indicateur options vous permet de spécifier s'il faut rechercher des fichiers ou des répertoires. Par défaut, cet indicateur est défini sur LocateFile.

Renvoie la liste de tous les fichiers trouvés.

Voir aussi QStandardPaths::locateAll().

void setTestModeEnabled(bool testMode)

Si testMode est true, cela active un "mode test" spécial dans QStandardPaths, qui modifie les emplacements accessibles en écriture pour qu'ils pointent vers des répertoires de test. Cela empêche les tests automatiques de lire ou d'écrire dans la configuration de l'utilisateur actuel.

Cela affecte les emplacements dans lesquels les programmes de test peuvent écrire des fichiers : GenericDataLocation, AppDataLocation, ConfigLocation, GenericConfigLocation, AppConfigLocation, StateLocation, GenericStateLocation, GenericCacheLocation, et CacheLocation. Les autres emplacements ne sont pas concernés.

Sous Unix, XDG_DATA_HOME correspond à ~/.qttest/share, XDG_CONFIG_HOME correspond à ~/.qttest/config, XDG_STATE_HOME correspond à ~/.qttest/state et XDG_CACHE_HOME correspond à ~/.qttest/cache.

Sous macOS, les données vont à ~/.qttest/Application Support, le cache à ~/.qttest/Cache et la configuration à ~/.qttest/Preferences.

Sous Windows, tout va dans un répertoire "qttest" sous %APPDATA%.

Voir aussi QStandardPaths::setTestModeEnabled().

list<url> standardLocations(StandardLocation type)

Renvoie tous les répertoires auxquels appartiennent les fichiers de type.

La liste des répertoires est triée de la plus haute à la plus basse priorité, en commençant par writableLocation() s'il est possible de le déterminer. Cette liste est vide si aucun emplacement pour le type n'est défini.

Voir aussi QStandardPaths::standardLocations().

url writableLocation(StandardLocation type)

Renvoie le répertoire dans lequel les fichiers de type doivent être écrits, ou une chaîne vide si l'emplacement ne peut être déterminé.

Voir aussi QStandardPaths::writableLocation().