Categories: Symbian C++ | S60 | Localization | How To | Code Examples

This page was last modified 20:22, 17 May 2008.

From Forum Nokia Wiki

The language constants are defined in e32const.h.

Define the languages that your component is localized to in your .mmp file:

// file: MyApp.mmp
 
...
 
LANG 01 02 16 // UK English, French, Russian

Place logical strings for different languages in different language-specific files. Dont forget to define the file encoding for those languages that use character sets beyond basic ASCII. For instance:

// file: MyApp.l01 (ELangEnglish = 01)
 
#define message_wait     "Please wait..."

// file: MyApp.l02 (ELangFrench = 02)
 
// the file has to be encoded in UTF-8 for the strings to be rendered correctly:
CHARACTER_SET UTF8 
 
#define message_wait   "Attendez, s'il-vous plait..."

// file: MyApp.l16 (ELangRussian = 16)
 
// the file has to be encoded in UTF-8 for the strings to be rendered correctly:
CHARACTER_SET UTF8
 
#define message_wait   "Пожалуйста, подождите ..."

In file MyApp.rls, include the correct language-specific file:

// file: MyApp.rls
CHARACTER_SET UTF8
 
#if defined LANGUAGE_01
  #include "MyApp.l01"
#elif defined LANGUAGE_02
  #include "MyApp.l02"
#elif defined LANGUAGE_16
  #include "MyApp.l16"
#endif

In MyApp.rss, define the resources based on the strings defined in the language-specific file that was included by MyApp.rls:

// file: MyApp.rss
#include <eikon.rh>
#include "MyApp.rls"
 
RESOURCE TBUF r_message_wait { buf = message_wait; }

In your code, use the localized strings as follows. The string denoted by R_MESSAGE_WAIT will be displayed in the appropriate language. Note the change from lower-case to upper-case.

//file: testexample.cpp
#include <stringloader.h>
...
...
HBufC* message = StringLoader::LoadL( R_MESSAGE_WAIT );
CAknInformationNote* note = new ( ELeave ) CAknInformationNote( ETrue );
note->ExecuteLD( *message );
delete message;

Finally, add the localized language resources to the package file:

;; file: MyApp.pkg 
 
...
 
; languages supported:
&EN,FR,RU
 
; localization:
{
"$(EPOCROOT)epoc32\data\z\resource\apps\MyApp.r01"
"$(EPOCROOT)epoc32\data\z\resource\apps\MyApp.r02"
"$(EPOCROOT)epoc32\data\z\resource\apps\MyApp.r16"
}-"!:\resource\apps\MyApp.rsc"