System.SysUtils.TFormatSettings

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

TFormatSettings = record

C++

struct DECLSPEC_DRECORD TFormatSettings
{
public:
    struct DECLSPEC_DRECORD TEraInfo
    {
    public:
        System::UnicodeString EraName;
        int EraOffset;
        System::TDate EraStart;
        System::TDate EraEnd;
    };
private:
    typedef System::StaticArray<System::UnicodeString, 12> _TFormatSettings__1;
    typedef System::StaticArray<System::UnicodeString, 12> _TFormatSettings__2;
    typedef System::StaticArray<System::UnicodeString, 7> _TFormatSettings__3;
    typedef System::StaticArray<System::UnicodeString, 7> _TFormatSettings__4;
    typedef System::DynamicArray<TEraInfo> _TFormatSettings__5;
private:
    static void __fastcall GetDayNames(TLocaleID Locale, TFormatSettings &AFormatSettings);
    static void __fastcall GetMonthNames(TLocaleID Locale, TFormatSettings &AFormatSettings);
    static void __fastcall GetEraInformation(TLocaleID Locale, TFormatSettings &AFormatSettings);
    static System::UnicodeString __fastcall GetString(TLocaleID Locale, int LocaleItem, int DefaultIndex, void * const *DefaultValues, const System::NativeInt DefaultValues_High);
private:
    static System::UnicodeString __fastcall TranslateDateFormat(TLocaleID Locale, int LocaleType, const System::UnicodeString Default, const System::WideChar SepDate, const System::WideChar SepTime)/* overload */;
    static System::UnicodeString __fastcall TranslateDateFormat(const System::UnicodeString Format, TLocaleID Locale, const System::WideChar SepDate, const System::WideChar SepTime)/* overload */;
    static System::UnicodeString __fastcall TranslateTimeFormat(TLocaleID Locale, int LocaleType, const System::UnicodeString Default, const System::WideChar SepTime)/* overload */;
    static System::UnicodeString __fastcall TranslateTimeFormat(const System::UnicodeString Format, TLocaleID Locale, const System::WideChar SepTime)/* overload */;
    static System::UnicodeString __fastcall AdjustLocaleName(const System::UnicodeString LocaleName, const System::UnicodeString ACharSet = System::UnicodeString());
public:
    System::UnicodeString CurrencyString;
    System::Byte CurrencyFormat;
    System::Byte CurrencyDecimals;
    System::WideChar DateSeparator;
    System::WideChar TimeSeparator;
    System::WideChar ListSeparator;
    System::UnicodeString ShortDateFormat;
    System::UnicodeString LongDateFormat;
    System::UnicodeString TimeAMString;
    System::UnicodeString TimePMString;
    System::UnicodeString ShortTimeFormat;
    System::UnicodeString LongTimeFormat;
    _TFormatSettings__1 ShortMonthNames;
    _TFormatSettings__2 LongMonthNames;
    _TFormatSettings__3 ShortDayNames;
    _TFormatSettings__4 LongDayNames;
    _TFormatSettings__5 EraInfo;
    System::WideChar ThousandSeparator;
    System::WideChar DecimalSeparator;
    System::Word TwoDigitYearCenturyWindow;
    System::Byte NegCurrFormat;
    System::UnicodeString NormalizedLocaleName;
    static TFormatSettings __fastcall Create()/* overload */;
    static TFormatSettings __fastcall Create(TLocaleID Locale)/* overload */;
    static TFormatSettings __fastcall Create(const System::UnicodeString LocaleName)/* overload */;
    static TFormatSettings __fastcall Invariant();
    int __fastcall GetEraYearOffset(const System::UnicodeString Name);
};

Propriétés

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

Description

TFormatSettings définit un contexte de formatage de chaînes thread-safe.

TFormatSettings définit une structure de données contenant des informations locales utilisées par la routine de formatage de chaînes. Chaque membre de TFormatSettings est équivalent à la variable globale de même nom. Une variable de type TFormatSettings définit un contexte thread-safe utilisable par les fonctions de formatage à la place du contexte global par défaut (lequel n'est pas thread-safe).

Pour créer et utiliser l'environnement thread-safe défini par TFormatSettings, procédez comme suit :

  1. Définissez une variable de type TFormatSettings.
  2. Appelez TFormatSettings.Create pour remplir la variable TFormatSettings avec des informations locales.
  3. Passez la variable TFormatSettings en tant que dernier paramètre de la routine de formatage de chaînes.

Chaque routine acceptant un paramètre TFormatSettings est thread-safe, et est une surcharge d'une fonction équivalente qui se réfère aux variables de formatage globales.

Examples de code