System.SysUtils.GetLocaleFile

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetLocaleFile(const FileName: string): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall GetLocaleFile(const System::UnicodeString FileName);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Renvoie un chemin entièrement qualifié indiquant un fichier de paramètres régionaux. Le chemin est construit avec le nom de fichier fourni et les sous-répertoires des langues d'interface utilisateur préférées.

GetLocaleFile effectue les opérations suivantes :

  1. Le répertoire et le nom de base sont extraits du paramètre FileName.
  2. Le répertoire des paramètres régionaux qui correspond à l'une des langues d'interface utilisateur préférées est recherché dans répertoire. Si un tel répertoire est trouvé, son nom entièrement qualifié concaténé à nom de base est alors renvoyé. Sinon, le nom entièrement qualifié du paramètre FileName est renvoyé.

Exemple

Supposons que le répertoire en cours contient un répertoire nommé loc avec la structure suivante :

  • ab [répertoire]
  • en [répertoire]
  • en-US [répertoire]
    • F.LC [fichier]
  • ro [répertoire]

et que la liste des langues d'interface utilisateur préférées en cours (voir PreferredUILanguageList) contient :

  • EN-US
  • EN

Dans ce cas, si GetLocaleFile est appelée avec le paramètre loc\F.LC, la chaîne suivante est renvoyée :

<répertoire en cours>\loc\EN-US\F.LC

Vous pouvez voir que la chaîne renvoyée contient le sous-répertoire \EN-US.

Voir aussi