Page History

Configuration Settings

Global Localization Options

Enable at Displays → Localization → Enable Localization

Creating Dictionaries

Setup Process

1. Navigate to Displays → Localization
2. Click New to create dictionary
3. Name dictionary (e.g., "EN_PT", "EN_ES")
4. Enable required localization options
5. Click Load Strings to populate
6. Enter translations or use auto-translate

Import Wizard Settings

Runtime Language Switching

Set Active Dictionary

csharp

// Method 1: Direct assignment
@Client.Localization = "EN_PT";

// Method 2: Using method
@Client.SetLocalization("EN_ES");

// Check current dictionary
string current = @Client.Localization;

Culture Information

csharp

// Set culture for formatting
@Client.CultureInfo = "pt-BR";  // Portuguese (Brazil)
@Client.CultureInfo = "en-US";  // English (US)
@Client.CultureInfo = "de-DE";  // German (Germany)

Configure default at Solution → Settings → Culture Info

Localization Table Properties

Component Localization

Automatic Translation

When Display Strings enabled:

• All display text auto-translates
• No code required
• Uses active dictionary

Manual Translation

For selective translation:

csharp

// Translate specific string
string translated = @Client.Locale("Original Text");

// In display binding
<TextBlock Text="{Client.Locale('Hello World')}" />

Custom Components

Components requiring special handling:

ComboBox Items:

csharp

public void LocalizeComboBox(ComboBox combo)
{
    foreach(var item in combo.Items)
    {
        item.Text = @Client.Locale(item.Text);
    }
}

DataTable Headers:

csharp

public void LocalizeTable(DataTable table)
{
    foreach(DataColumn col in table.Columns)
    {
        col.Caption = @Client.Locale(col.Caption);
    }
}

Best Practices

1. Plan Languages Early - Define requirements upfront
2. Use Consistent Keys - Standardize original text
3. Keep Text Separate - Avoid hardcoded strings
4. Test All Languages - Verify layout with longest text
5. Consider Culture - Format dates/numbers appropriately
6. Document Context - Add descriptions for translators
7. Update Regularly - Maintain dictionary synchronization

Language Switching Example

Implementation Steps

1. Enable Localization

   ? Display Strings
   ? Alarm Messages
   ? System Messages

1. Create Dictionary
   • Name: "EN_PT"
   • Load strings from displays
   • Translate "Button" → "Botão"
2. Runtime Switch

csharp

   // In ClientStartup task
   @Client.Localization = "EN_PT";

1. Result
   • Original: "Button"
   • Display: "Botão"

Culture-Specific Formatting

Date/Time

csharp

// US Format: 3/15/2024
@Client.CultureInfo = "en-US";

// European: 15/03/2024
@Client.CultureInfo = "fr-FR";

// ISO Format: 2024-03-15
@Client.CultureInfo = "invariant";

Numbers

csharp

// US: 1,234.56
@Client.CultureInfo = "en-US";

// European: 1.234,56
@Client.CultureInfo = "de-DE";

Translation Services

Supported Providers

• Azure Translator - Microsoft service
• Google Translate - Google API
• LibreTranslate - Open source

Configuration

1. Set API credentials
2. Select source/target languages
3. Click Translate button
4. Review and adjust results

Troubleshooting

Text not translating:

• Verify dictionary active
• Check localization enabled
• Confirm string in dictionary
• Review component settings

Wrong formatting:

• Check CultureInfo setting
• Verify OS regional settings
• Test with different cultures

Missing strings:

• Click Load Strings again
• Check all sources enabled
• Review new/modified displays
• Update dictionary

Layout issues:

• Test with longest translations
• Allow controls to auto-size
• Consider text direction (RTL)
• Verify font support

Performance Considerations

Dictionary Loading

• Load at startup
• Cache in memory
• Minimize switches
• Preload all needed

String Lookup

• Use consistent keys
• Avoid runtime concatenation
• Cache frequently used
• Batch translations

Advanced Features

Dynamic Dictionary Loading

csharp

// Load dictionary from database
DataTable dict = @Dataset.Query.Translations.SelectCommand();
@Client.LoadDictionary(dict);

Fallback Languages

csharp

// Try primary, then fallback
string text = @Client.Locale("Key") ?? 
              @Client.Locale("Key", "EN") ?? 
              "Default Text";

Configuring Display Localization

You can localize the text in your application in as many languages as needed. To do this, create a dictionary for each language. 

Create a Dictionary

• Go to Displays → Localization.
• Click New.
• After selecting the Enable Localization (Global Solution Setting), click Load Strings to populate the table. In the TranslatedText column, enter the text in the dictionary language (or use the online service translation mentioned above in Translate).
• The language can be set in rutime with the code below:
  @Client.Localization = "<DictionaryName>";
  @Client.SetLocalization("<DictionaryName>");

CultureInfo

In Solution / Settings, you can define the default Culture Information that the application is using. The runtime property Client.CultureInfo allows you to change it during runtime. Some display controls such as Calendars, may get the Culture Info directly from the Operating System. In this situation, the correct procedure is for both the Operating System settings and the solution settings to have the application's target culture. For example, to change the Culture Info to Portuguese (Brazil): @Client.CultureInfo = "pt-BR".

Language Switching Example

For an example on how to switch the language of a solution, check out Localization Solution. In summary, there are some things to look for when preparing your solution's localization:

Most of the components on display can be translated by changing the property @Client.Localization or using the method @Client.SetLocalization, as described above. If you want to translate just some strings but not all, you can use @Client.Locale method. For example, to localize a TextLabel component:
Image Removed

@Client.Localization = "En_pt";

In this section...