Language Support

ImageEn provides full localization for twenty-five languages: Arabic, Chinese (Simplified and Traditional), Czech, Danish, Dutch, English, Farsi, Finnish, French, German, Greek, Hungarian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Russian, Serbian, Slovenian, Spanish, Swedish and Turkish (Note: machine translation has been used for some localization).

To support localization, you must add the ielang32.dll (for 32bit EXEs) or ielang64.dll (for 64bit EXEs) to your application exe folder (See ImageEn DLL info).

These languages are used in ImageEn dialogs (such as when editing and printing images) and by ImageEn Actions. Changing the current language requires only setting IEGlobalSettings().MsgLanguage, although the default is msSystem so it should automatically display the correct language for the user. To test the localization, try the demos in the \Actions\ folder.

- If you require localization support without using a DLL you need to undefine IESupportLanguageDLL in You may need to recompile your packages
- You can check the coverage for specific languages by reviewing iewords.pas. If you update any of the translated strings, please email your changes to
- Some languages that use extended character sets, such as msArabic, msChinese, msChineseTraditional, msJapanese, msKorean and msRussian, require a Unicode compatible Delphi/C++ version (2009 or newer)


// Set language to Italian
IEGlobalSettings().MsgLanguage := msItalian;

// Change language to Italian and show warning if language dll is not found
IEGlobalSettings().RegisterPlugIns([ iepiLanguages ]);
if not ( iepiLanguages in IEGlobalSettings().ActivePlugIns ) then
  ShowMessage( 'IELang32.dll not found. Please reinstall.' )
  IEGlobalSettings().MsgLanguage := msItalian;

// Use ImageEn to localize your buttons
btnOK.Caption := IEGlobalSettings().GetLanguageWord( IEMSG_OK );
btnCancel.Caption := IEGlobalSettings().GetLanguageWord( IEMSG_Cancel );

// Customize ImageEn's translation
IEGlobalSettings().SetLanguageWord( msEnglish, IEMSG_OK, 'Yeah, dude!' );
IEGlobalSettings().SetLanguageWord( msEnglish, IEMSG_Cancel, 'Nah...' );

Language Selector Example

// Create a pop up menu to select language

procedure AddLanguagesToMenu(Pop: TPopupMenu; OnClick: TNotifyEvent);
  langs: TMsgLanguages;
  i: Integer;
  aLang : TMsgLanguage;
  NewItem: TMenuItem;
  langs := IEGlobalSettings().GetLanguages();
  for i := Low( langs ) to High( langs ) do
    aLang := langs[ i ];
    NewItem := TMenuItem.Create( Pop.Owner );
    NewItem.Caption := LanguageToStr( aLang, True );
    NewItem.Hint := format( iemsg( IEMsg_SetLanguageToX ), [ LanguageToStr( aLang , False ) ]);
    NewItem.Checked := IEGlobalSettings.MsgLanguage = aLang;
    NewItem.Tag := ord(aLang);
    NewItem.OnClick := OnClick;

    // Add separator for "Default"
    if aLang = msSystem then
      NewItem := TMenuItem.Create( Pop.Owner );
      NewItem.Caption := '-';

procedure TfrmMain.LanguageClick(Sender: TObject);
  aLang : TMsgLanguage;
  I: Integer;
  for I := 0 to popLanguage.Items.Count - 1 do
    popLanguage.Items[I].Checked := False;
  aLang := TMsgLanguage(TMenuItem(Sender).Tag);

    IEGlobalSettings.MsgLanguage := aLang;
    TMenuItem(Sender).Checked := True;
    MessageDlg( 'IELang32.dll not found! Copy it to the EXE folder for localization support.', mtInformation, [ mbOK ], 0 );

procedure TfrmMain.PopupLanguageMenuAtControl(Control: TControl);
  if popLanguage.Items.Count = 0 then
    AddLanguagesToMenu( popLanguage, LanguageClick );
  popLanguage.Popup( Control.ClientOrigin.X, Control.ClientOrigin.Y + Control.Height )

See Also

- MsgLanguage
- GetLanguages
- GetLanguageWord
- SetLanguageWord
- UpdateLanguage
- LanguageToStr