Sur cette page

StandardPaths QML Type

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

Import Statement: import QtCore
Since: Qt 6.2
Inherits:

QtObject

Méthodes

Description détaillée

Le type singleton StandardPaths fournit des méthodes d'interrogation des 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 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.

Remarque : sous Windows, les extensions habituelles des exécutables (provenant de la variable d'environnement PATHEXT) sont automatiquement ajoutées. Par exemple, l'appel findExecutable("foo") trouve foo.exe ou foo.bat s'il est présent.

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 absolu pointant vers un exécutable, son chemin 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().

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é.

Remarque : l'emplacement de stockage renvoyé peut ne pas exister, c'est-à-dire qu'il peut devoir être créé par le système ou l'utilisateur.

Voir aussi 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.