System.SysUtils.TFormatSettings

提供: RAD Studio API Documentation
移動先: 案内検索

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);
};

プロパティ

種類 可視性 ソース ユニット
record
struct
public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils


説明

TFormatSettings では、スレッドセーフな文字列書式設定コンテキストを定義しています。

TFormatSettings では、文字列書式設定ルーチンで使用するロケール情報を含むデータ構造を定義しています。 TFormatSettings の各メンバは、同じ名前のグローバル変数と同等です。 TFormatSettings 型の変数にはスレッドセーフなコンテキストが定義されており、書式設定関数では、スレッドセーフではないデフォルトのグローバル コンテキストの代わりにこのコンテキストを使用することができます。

TFormatSettings で定義されたスレッドセーフな環境を作成して使用する手順は以下のとおりです。

  1. TFormatSettings 型の変数を宣言します。
  2. TFormatSettings.Create を呼び出して、TFormatSettings 変数にロケール情報を設定します。
  3. TFormatSettings 変数を文字列書式設定ルーチンの最後のパラメータとして渡します。

TFormatSettings パラメータを受け取るルーチンはどれも、スレッドセーフであり、グローバルな書式設定変数を参照する同等の関数をオーバーロードしています。

コード サンプル