StandardPaths QML Type

Permet d'accéder aux chemins d'accès système standard. En savoir plus...

• 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)
• list<url> standardLocations(StandardLocation type)
• url writableLocation(StandardLocation type)

Description détaillée

Le type singleton StandardPaths fournit des méthodes permettant d'interroger les chemins d'accès standard du système.

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

Voir également QStandardPaths.

Documentation des méthodes

string displayName(StandardLocation type)

Renvoie un nom d'affichage localisé pour l'emplacement donné type ou une chaîne vide QString si aucun emplacement correspondant n'est trouvé.

Voir également QStandardPaths::displayName().

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

Recherche le fichier exécutable nommé « executableName » dans le répertoire spécifié « paths », ou dans les chemins d'accès système si « paths » est vide.

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

Renvoie le chemin d’accès absolu vers l’exécutable, ou une chaîne vide s’il est introuvable.

Si le chemin executableName fourni est un chemin absolu pointant vers un exécutable, c’est son chemin « propre » qui est renvoyé.

Voir aussi QStandardPaths::findExecutable().

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

Recherche un fichier ou un répertoire nommé « fileName » dans les emplacements par défaut pour type.

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

Renvoie le chemin absolu du 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 par défaut de « type ».

L'indicateur « options » vous permet de préciser 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().

list<url> standardLocations(StandardLocation type)

Renvoie tous les répertoires dans lesquels se trouvent les fichiers de type « type ».

La liste des répertoires est triée par ordre décroissant de priorité, en commençant par writableLocation() si celui-ci peut être déterminé. Cette liste est vide si aucun emplacement n’est défini pour le type.

Voir également ` QStandardPaths::standardLocations()`.

url writableLocation(StandardLocation type)

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

Voir aussi QStandardPaths::writableLocation().