|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-DC77555F-ADAF-5BCA-A5D6-89B8CDC69848" xml:lang="en"><title>Localisation |
|
13 Overview</title><shortdesc>Overview of localisation support that is available with Symbian |
|
14 platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <section id="GUID-D6B74179-E4D2-58C7-8052-FC4D3A8B8901"><title>Purpose</title> <p>Localisation |
|
16 allows the Symbian device to handle locale-sensitive information: for example |
|
17 language used and how the date and currency are displayed. This collection |
|
18 makes up what Symbian platform defines as a locale. </p> <p>On Symbian platform, |
|
19 the locale settings are stored in class <xref href="GUID-53299759-C2DD-3ABC-A055-9AFE7C5081C6.dita"><apiname>TLocale</apiname></xref>. </p> </section> |
|
20 <section id="GUID-1FB54949-51E2-5CE5-A048-32C55B21F90A"><title>Architecture</title> <p>There |
|
21 are two sets of locale settings, those that are hard-coded into the phone |
|
22 and those that are stored in a <filepath>locale.dll</filepath>. The device |
|
23 creator produces both the hard-coded localisation settings and the locale.dll. </p> </section> |
|
24 <section id="GUID-659B3E29-4867-5051-87BE-A23189CE8F7D"><title>Description</title> <p>The |
|
25 localisation API is used to set locale-sensitive information that can be changed |
|
26 by the user; namely, locale, calendar settings, country code, currency format, |
|
27 date and time format, numerical values and time zone information. </p> </section> |
|
28 <section id="GUID-FDB7C3AB-1731-4A8B-878A-257529491AA5"><title>Using Localisation |
|
29 Support</title> <p>The locale DLL is created by the phone manufacturer and |
|
30 only the settings application provided by the UI vendor can change the settings |
|
31 or values. </p> <p>The locale setup process is controlled by the <xref href="GUID-BF4C6A23-EE56-3C92-B980-9D6CB5EB4784.dita"><apiname>EStart</apiname></xref> component |
|
32 and goes through three phases: </p> <ul> |
|
33 <li id="GUID-F908A0E6-94B9-5481-B272-21A65EA99D29"><p>Set the hard-coded defaults, </p> </li> |
|
34 <li id="GUID-7B2080BD-B4B6-5668-8B65-8604C5017A6B"><p>Load the locale from |
|
35 the HAL settings and load the required locale, and </p> </li> |
|
36 <li id="GUID-41FF6A2A-90D7-53F0-BBCD-F75089EB0111"><p>Request update notifications </p> </li> |
|
37 </ul> <p>The device creator produces both the hard-coded values and the <filepath>locale.dll</filepath>. </p> <p>The |
|
38 locale DLL files are named on the pattern <filepath>eloc1.XYZ</filepath>, |
|
39 where <codeph>XYZ</codeph> is the language number as defined by <xref href="GUID-698538DF-DCDC-347B-BD32-DD9EB896BAFB.dita"><apiname>TLanguage</apiname></xref> enumeration |
|
40 defined in <filepath>e32lang.h</filepath>. </p> </section> |
|
41 </conbody><related-links> |
|
42 <link href="GUID-C497F36F-BCA8-569D-826A-64EAD75C887C.dita"><linktext>Locale Settings |
|
43 Overview</linktext></link> |
|
44 <link href="GUID-80698E62-E310-59CA-A524-5CF44C437BE4.dita"><linktext>Base Starter</linktext> |
|
45 </link> |
|
46 </related-links></concept> |