Class TExtendedLocale

class TExtendedLocale;

Description

Extended locale class

This class holds a collection of locale information. It contains a TLocale internally. It has methods to load a locale DLL and to set the system wide locale information.

Members

Defined in TExtendedLocale:

• GetCurrencySymbol()Get the Currency Symbol from SLocaleLocaleSettings object
• GetLocale()
• GetLocaleDllName(TLocaleAspect,TDes &)Returns the name of the DLL containing the given bits of locale information
• GetLongDateFormatSpec()Get the Long Date Format from SLocaleTimeDateFormat object
• GetPreferredCollationMethod(TInt)
• GetShortDateFormatSpec()Get the Short Date Format from SLocaleTimeDateFormat object
• GetTimeFormatSpec()Get the Time Format from SLocaleTimeDateFormat object
• LoadLocale(const TDesC &)Loads a locale Dll and get the locale information
• LoadLocaleAspect(TUint,const TDesC &)Loads a DLL and get some locale information
• LoadSystemSettings()Load system wide locale settings
• SaveSystemSettings()Make the current locale information system wide
• SetCurrencySymbol(const TDesC &)Sets the currency symbol
• TExtendedLocale()Default constructor.

IMPORT_C TExtendedLocale();

Description

Default constructor.

It constructs an empty object

This is an empty copy of TExtendedLocale. To get the system locale you can use TExtendedLocale::LoadSystemSettings(). The current settings may be saved to the system with TLocale::SaveSystemSettings().

See also:

• TExtendedLocale::LoadSystemSettings()Load system wide locale settings
• TExtendedLocale::SaveSystemSettings()Make the current locale information system wide

IMPORT_C void LoadSystemSettings();

Description

Load system wide locale settings

It initialises this TExtendedLocale with the system wide locale settings. The settings stored in the TExtendedLocale are overwritten with the system wide locale.

See also:

• TExtendedLocale::SaveSystemSettings()Make the current locale information system wide

IMPORT_C TInt SaveSystemSettings();

Description

Make the current locale information system wide

It overwrites the system wide locale information with the locale information stored in this TExtendedLocale. This will generate a notification for system locale changes. In case of an error, the locale might be in an unconsistent state.

Return value

IMPORT_C TInt LoadLocale(const TDesC &aLocaleDllName);

Description

Loads a locale Dll and get the locale information

It loads a locale DLL and it initialises the contents of this TExtendedLocale with the locale information stored in the DLL. The locale information is only stored in this TExtendedLocale. If you want to set the system wide settings with the locale information in the DLL, you can call TExtendedLocale::SaveSystemSettings() after calling this function.

Parameters

Return value

See also:

• TExtendedLocale::SaveSystemSettings()Make the current locale information system wide

IMPORT_C TInt LoadLocaleAspect(TUint aAspectGroup, const TDesC &aLocaleDllName);

Description

Loads a DLL and get some locale information

It loads the specified locale DLL and depending on the aAspectGroup it overwrites locale information in this TExtendedLocale with the locale information stored in the DLL. aAspectGroup is a bitmap of TLocaleAspect values specifying what to be overwritten. The locale information is only stored in this TExtendedLocale. If you want to set the system wide settings with the locale information in the DLL, you can call TExtendedLocale::SaveSystemSettings() after calling this function.

Parameters

Return value

See also:

• TExtendedLocale::SaveSystemSettings()Make the current locale information system wide

IMPORT_C TInt SetCurrencySymbol(const TDesC &aSymbol);

Description

Sets the currency symbol

It sets the currency symbol. The maximum lenght for the currency symbol is KMaxCurrencySymbol. Trying to pass a descriptor longer than that, will result in a panic.

Parameters

Return value

Panic codes

IMPORT_C TInt GetLocaleDllName(TLocaleAspect aLocaleDataSet, TDes &aDllName);

Description

Returns the name of the DLL containing the given bits of locale information

Given the bits of locale information specified in aLocaleDataSet, it returns the name of the locale DLL storing the information. TExtendedLocale can contain information from different DLLs.

Parameters

Return value

IMPORT_C TCollationMethod GetPreferredCollationMethod(TInt index=0);

Description

Parameters

Return value

IMPORT_C TPtrC GetCurrencySymbol();

Description

Get the Currency Symbol from SLocaleLocaleSettings object

Return value

IMPORT_C TPtrC GetLongDateFormatSpec();

Description

Get the Long Date Format from SLocaleTimeDateFormat object

Return value

IMPORT_C TPtrC GetShortDateFormatSpec();

Description

Get the Short Date Format from SLocaleTimeDateFormat object

Return value

IMPORT_C TPtrC GetTimeFormatSpec();

Description

Get the Time Format from SLocaleTimeDateFormat object

Return value

inline TLocale* GetLocale();

Description

Return value