Symbian3/SDK/Source/GUID-9EA7B72B-8394-48B8-A0CC-4BB34CBDB01C.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-9EA7B72B-8394-48B8-A0CC-4BB34CBDB01C.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-9EA7B72B-8394-48B8-A0CC-4BB34CBDB01C" xml:lang="en"><title>UI text
+strings</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Mobile device users can select the language used by their devices for
+UI texts. Symbian platform native applications typically use these language
+settings to determine which language is displayed when an application is launched.
+The language used in your application depends on how you have implemented
+your UI texts:</p>
+<ul>
+<li><p><i>Recommended</i>: In the recommended approach, text strings
+in resource files are mapped to logical names in the code. This means that
+your application can switch between different language packs according to
+locale and the wishes of the end-user.</p></li>
+<li><p><i>Not recommended</i>: If you hard code text strings into
+your code, then your application will only be in the language used in the
+code and will not be able to take advantage of the flexibility made available
+by the recommended approach described approach.</p></li>
+</ul>
+<p>In the recommended approach, when the application framework launches
+an application, it loads the application resource file. The application framework
+compares the system locale language setting with the available resource files,
+and loads the resource file whose extension matches the locale language code.
+If there is no match, then the system loads the resource file with the extension <parmname>rsc</parmname>.</p>
+<p>For example, if the language of a device is set to German, then the
+application framework attempts to find a resource file for the application
+with the extension <parmname>r03</parmname>, since <parmname>03</parmname> is
+the code for German. If there is no resource file with a matching extension,
+then the application framework loads the resource file for the application
+with the extension <parmname>rsc</parmname>.</p>
+<p>In order to ensure that your application will be localizable:</p>
+<ul>
+<li><p>Do not embed UI text strings in your code files</p></li>
+<li><p>Do not hard code the size of text buffers</p></li>
+</ul>
+</conbody></concept>
\ No newline at end of file