System.SysUtils.GetLocaleFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetLocaleFile(const FileName: string): string;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Beschreibung

Gibt einen voll qualifizierten Pfad zurück, der eine Sprachdatei angibt. Der Pfad wird aus dem angegebenen Dateinamen und den Unterverzeichnissen mit den bevorzugten UI-Sprachen zusammengestellt.

GetLocaleFile führt die folgenden Operationen aus:

  1. Das Verzeichnis und der Basisname werden aus dem Parameter FileName extrahiert.
  2. Das Sprachverzeichnis, das einer beliebigen bevorzugten UI-Sprache entspricht, wird in Verzeichnis gesucht. Wenn ein derartiges Verzeichnis gefunden wird, dann wird dessen mit dem Basisnamen verketteter, voll qualifizierter Name zurückgegeben, andernfalls wird der voll qualifizierter Name des FileName-Parameters zurückgegeben.

Beispiel

Angenommen, das aktuelle Verzeichnis enthält ein Verzeichnis namens loc mit der folgenden Struktur:

  • ab [Verzeichnis]
  • en [Verzeichnis]
  • en-US [Verzeichnis]
    • F.LC [Datei]
  • ro [Verzeichnis]

und die aktuell bevorzugte UI-Sprachenliste (siehe PreferredUILanguageList) enthält:

  • EN-US
  • EN

Wird GetLocaleFile mit dem Parameter loc\F.LC aufgerufen, wird in diesem Fall der folgende String zurückgegeben:

<current directory>\loc\EN-US\F.LC

Wie Sie sehen, enthält der zurückgegebene String das Unterverzeichnis \EN-US.

Siehe auch