S60 Platform: Chinese Display Example v2.1
------------------------------------------
This C++ application demonstrates how to display Chinese characters, support
internationalization and localization, and implement context-sensitive helps. The
application supports the following languages: English, Taiwan Chinese, Taiwan English,
Hong Kong Chinese, Hong Kong English, Mainland Chinese, and Mainland English.
-------------------------------------------------------------------------------------
PREREQUISITES
Symbian C++ basics
-------------------------------------------------------------------------------------
IMPORTANT CLASSES
TFontSpec
CCnvCharacterSetConverter
-------------------------------------------------------------------------------------
KNOWN ISSUES
The application UID must be from a protected range to be able to show the
Context-Sensitive Help.
-------------------------------------------------------------------------------------
NOTES ON LOCALIZATION
The supported languages and their language codes are:
01 English
029 Taiwan Chinese
157 Taiwan English
030 HongKong Chinese
158 HongKong English
031 Mainland Chinese
159 Mainland English
Note that the localization file for Chinese language (language.l31) must be in UTF-8
format and must NOT contain the 3-byte BOM (Byte Order Marker, <0xEF><0xBB><0xBF>)
in the beginning of the file, otherwise the compilation will fail. Some text editors
may automatically add the UTF-8 BOM, and it must be manually removed using a hex
editor. Note that whenever the file is modified, the above 3 characters must be
removed again to get the file compiled.
-------------------------------------------------------------------------------------
NOTES ON CONTEXT-SENSITIVE HELP
To build the help for another language code, please rename the corresponding
language .rtf file to "ChineseDisplay.rtf", then rebuild the project again. The newly
generated .hlp shoud be renamed to the corresponding help file.
For example, to build help for language code "31", delete "ChineseDisplay.rtf" first,
rename "ChineseDisplay_31.rtf" to "ChineseDisplay.rtf". Build the project. Then, rename
"ChineseDisplay.hlp" to "ChineseDisplay.h31".
The application UID must be from a protected range to be able to show the
Context-Sensitive Help.
-------------------------------------------------------------------------------------
RUNNING THE EXAMPLE
The example application provides three menu commands showing an info message (on the
emulator only), a notification and launching context-sensitive help.
The example application works on Chinese and non-Chinese S60 3rd Edition devices. On
devices supporting Chinese, both Chinese and English language resources are installed.
Thus the application UI is displayed either in Chinese or in English depending on the
device language in use.
-------------------------------------------------------------------------------------
BUILD & INSTALLATION INSTRUCTIONS
The source code can be compiled on the S60 3rd Edition SDKs.
Steps for building and installing the application to a device depend on the S60
platform version:
--Mobile device (S60 3rd Edition)
a) Go to: "<ChineseDisplay example dir>\group"
b) Run: "bldmake bldfiles"
c) Run: "abld build gcce urel"
d) Go to: "<ChineseDisplay example dir>\sis
e) Run: "makesis ChineseDisplay_30_gcce.pkg"
f) Sign the sis package
See www.symbiansigned.com for information about Developer Certificates.
g) Install the signed .sis file to a S60 3rd Edition device.
----------------------------------------------------------------------------------------
COMPATIBILITY
S60 3rd Edition
S60 3rd Edition, FP1
S60 3rd Edition, FP2
The example application is expected to work on all S60 3rd Edition devices as it provides
both Chinese and English language resources. However, the Chinese characters can only be
displayed on devices supporting Chinese.
Created with S60 3rd Edition, FP1 SDK.
----------------------------------------------------------------------------------------
VERSION HISTORY
v2.1 New languages added: Taiwan Chinese, Taiwan English, Hongkong English, Mainland
English. Support for Context-sensitive Help added. Support for S60 2nd Edition dropped.
v2.0 Ported to S60 3rd Edition (also supporting S60 2nd Edition).
v1.0 Initial version supporting English and Mainland Chinese. Supports S60 2nd Edition.
----------------------------------------------------------------------------------------
EVALUATE THIS RESOURCE
Please spare a moment to help us improve documentation quality and recognize the examples
you find most valuable, by rating this resource at
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=ba05733d-bc27-4080-94fd-777
ea27aadf8/S60_Platform_Chinese_Display_Example_v2_1_en.zip