Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles
(untagged)

Multilingual Support in C#

0.00/5 (No votes)
18 Oct 2002 2  
The article gives an introduction on how to develop multilingual applications using C#

Introduction

The computer is now in use in almost all parts of the world and therefore work is in progress to give support to languages other than English. Many major languages of the world like Arabic, Hindi and Chinese are not written in Roman Script, so special features are provided for dealing with these languages. This article will tell how to implement multilingual application using C#. Our Example Script will be Arabic. But it can be generalized to any major language of the world.

Details

C# stores character in the form of Unicode Characters. Unicode is a 16 bit encoding scheme of characters and has characters of all major languages of the world like Arabic, Urdu, Hindi, Chinese, Korean, Hebrew etc. Every character has a Unicode code point, e.g. Arabic Character Aleph has codepoint 1575. To display different languages and script, one has to install support for the script. Windows 2000 has support for displaying many scripts. Script is the writing style of language. For example, English and many western languages are written in Roman Script. Arabic, Farsi, Urdu are written in Arabic Script. Hindi, Bengali, Tamil are written in Indic Script. Every script has its own features. Arabic Script is written from left to right and characters changes their shape according to the context.

To install support for Arabic or any other Script. Open Control Panel --> Regional Options --> Language Setting for the System and check your desired Script (Arabic in our case). After checking Arabic click on OK and Arabic Script support is installed on your computer and you can have input locale in Arabic, Farsi and Urdu.

Regional Options

For input, keyboard for Arabic, Farsi and Other languages can be installed from Control Panel --> Keyboard --> Input Locale --> Add.

So it is the configuration for displaying multilingual text. Now we will start C# IDE and explore its features. Throughout the article we will only concentrate on the code written for multilingual features. The code for form creation, adding controls to form and event handling will be generated by the IDE and will not be discussed.

The first example is of Message Box. Create a Windows Application. Place a button in the centre of form. Set the name and text properties of the button to btnMessage and "Show Message" respectively. For displaying Message Box, add following code to the Click event of btnMessage.

protected void btnMessage_Click (object sender, System.EventArgs e)
{
    MessageBox.Show("English Text Example","English Title");
}

On Pressing F5, Form will be displayed and on clicking Show Message. Message Box will be displayed.

Messsage Box with English Text

Now for displaying Arabic text, type message and title using Arabic characters. The Message is " Urdu Text Example" and "Urdu Title" in Urdu Language.

C# Code for Urdu dispaly

The message box displayed by clicking Show Message Button will be

Messsage Box with Urdu Text

The Message box displays Urdu Text (in Arabic Script). but it has some problems. Arabic Script is written from Right to Left (The rightmost character is first character of string, and leftmost is the last character of string). So the text must be right aligned. In the above example both Title and Message are left aligned. Also the Title must be at right and the Close Button should be at left in a RightToLeft Scheme. This can be done by using style attributes as third parameter of MessageBox.Show method. Style Attributes are used to change the visual style and options of Message Box. For Example, for displaying a Cancel button with OK button, MessageBox.OKCancel is used as

MessageBox.Show("Message","Title",MessageBox.OKCancel);

For RightToLeft MessageBox, RTLReading field is used. And for right aligning the text, RightAlign field is used. So in our new example these two are ORed and passed to Show method of MessageBox (you can OR multiple fields to give their style to MessageBox).

C# Code for RightToLeft Display

Messsage Box with RightToLeft

In above examples, we use Windows 2000 support to insert Arabic (Urdu) characters to the code. But if the development environment does not have support for writing multilingual characters, then this work can be done by code. The character data type of C# stores characters as Unicode character. So we can declare variables of character and string type and assign characters and words of different languages to these variables.

In the next example, we will display word "Urdu" in Arabic Script in a textbox without using Arabic Keyboard of Windows 2000.

protected void button1_Click (object sender, System.EventArgs e)
{
    char aleph ;
    char ra;
    char dal;
    char wao;
    string word;
    aleph = '\u0627';
    ra = '\u0631';
    dal = '\u062F';
    wao = '\u0648';
    word = aleph.ToString() + ra.ToString()+dal.ToString()+ wao.ToString();
    textBox1.Text  = word;
}

Text Box with Urdu Text

During execution of the application, when we click on the button, word "urdu" in Arabic Script will be displayed in the textbox.

The word "urdu" in Arabic script consists of four characters: Aleph, Ra, Dal and Wao. So the Unicode values of these characters are stored in four variables. You can store any Unicode character in C# by giving its hexadecimal value as '\uXXXX'. Then next task is to concatenate these characters to have word. This is done by converting character to string (using ToString method). Finally the variable word( having Unicode string) is assigned to the text property of textbox. If Arabic Script support is installed on the system, then the word will be displayed in Right to Left direction.

The only problem with above code is that it is aligned to the right. All controls have a property RightToLeft. If this property is set to Yes, then not only text is displayed from Right to Left but also other features of controls have Right to Left direction. For Example, we place a ComboBox on the Form and add three items "Arabic", "Farsi" and "Urdu" (in Arabic Unicode Characters) to it.

Combo Box without RightToLeft

The Combo Box displays three words in Arabic Script but it does not have all Right to Left Features. In a Right To Left Control, all the words must be right aligned. Also the Dropdown Arrow must be at left of the control. Similarly if a control has vertical scrollbar then it must be at left of the control. This can be done by setting RightToLeft property of the control (e.g. our ComboBox) to Yes. After it, the output will be as desired.

Combo Box with RightToLeft

If RightToLeft property can have a third value Inherits. If a control has value Inherits then its RightToLeft value is same as of its Parent Control.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here