Click here to Skip to main content
15,868,016 members
Articles / Desktop Programming / MFC
Article

Internationalization and Multiple Language Support

Rate me:
Please Sign up or sign in to vote.
4.65/5 (44 votes)
14 Dec 20025 min read 1.1M   4.3K   129   124
Changing the language of a Windows program on the fly using resource only DLLs.

Sample Image - mult_lang_support.gif

Introduction

This is a simple article showing how one can internationalize a Windows program, changing the menu, accelerators, dialog boxes, and common dialogs (the file open dialog is used in this example) etc. on the fly. I have seen many questions on the newsgroups about this, but have yet to see a good, simple, example.

Background

This code is based on snippets of information found in various newsgroups.

Description

The code is contained primarily in one function, CMainFrame::SetLanguage, it is partially displayed below. The source code does have more comments and also has the ability to set the language based on the PC's locale.

If a resource DLL has been loaded we should remove it, this is done in the destructor.

if(m_hInstFrench)
   FreeLibrary(m_hInstFrench);

We simply branch on the language we want and load the relevant DLL using LoadLibrary. The library is kept in memory once it is loaded, because removing it when a new language was required caused problems with accelerators in NT4, this is described later.

if(!m_hInstFrench)
   m_hInstFrench = LoadLibrary(_T("LangFRA.dll"));

If a resource DLL was loaded we need to set the MultiLang's resource handle to the handle of the DLL from which the application’s resources will be loaded. Otherwise we use m_hInstEnglish, which is initially set to AfxGetInstanceHandle(), to obtain the current instance of the application, and use that to load the resource from the EXE.

if(hInst)
   AfxSetResourceHandle(hInst);
else
   AfxSetResourceHandle(m_hInstEnglish);

The menu has to be changed to be the one from our resource DLL. It should be noted that we need to get the menu from the CMainFrame, this is because we in effect need to force a change of any elements that are currently displayed. The dialog boxes, as you will see will be displayed in the correct language automatically, in this example, the About box.

New is used to create the new CMenu so we can then use SetMenu() to set the current menu to the new menu. This causes the window to be redrawn to reflect the menu change.

Any other redraws etc. must be done as well, such as updating the status bar with "Ready", using new accelerators, or re-painting any windows that display text.

CMenu *pMenuCurrent = GetMenu();

   // Create a new menu instance, we need to use this in SetMenu
m_pMenuNew = new CMenu;

   // has the menu changed?
   // m_hMenuDefault is the default menu resource for this frame see AFXWIN.H
if(pMenuCurrent->m_hMenu != m_hMenuDefault)
   {
      // Destroy the "New" menu and delete the resource
      // We, after all created it!
   pMenuCurrent->DestroyMenu();
   delete pMenuCurrent;
   }

   // Load our new resource, menu and
m_pMenuNew->LoadMenu(IDR_MAINFRAME);
   // Displauy the new menu
SetMenu(m_pMenuNew);

Date Display

Method CMainFrame::GetDate() shows how to use _tsetlocale() and _tcsftime() to display the current date the langauge we have specified.

Accelerators

These need to be loaded every time the language changes, during testing on NT4 it was found that if the resource only DLL was unloaded when not required the accelerators would not change the next time the language changed. So once loaded they stay in memory until no longer required. Each language uses a different set of accelerators as a test.

   // m_hAccelTable is used in Winfrm.cpp as the accelerator handle,
   // only one accelerator can be loaded at a time so we MUST clear it
m_hAccelTable = NULL;
bOK = LoadAccelTable(MAKEINTRESOURCE(IDR_MAINFRAME));

Custom Common Dialog

MSDN article Q102332 "How to Show a Custom Common Dialog using CFileDialog" describes how to do this using CFileDialog, this example uses the Win32 function GetOpenFileName(). Although the code is the same for both methods there appears to be a bug when using CFileDialog and Visual C++ 6.0, this will be investigated later.

The code for this is CMainFrame::OnFileOpen(). Visual C++ provides some templates, these can be found in one of the Visual C++ directories they have .dlg suffices, the example uses Fileopen.dlg, to use this do the following:-

  • Find the correct template from Fileopen.dlg.
  • Add this to your resource, open the resource as a text file to do this.
  • Select the resource and using View - Resource Includes menu, add #include <dlgs.h>, as a "Read-only symbol directive".
  • Add #include <dlgs.h> to the source file in which GetOpenFileName is to be used.

The OFN_ENABLETEMPLATE has to be added to the Flags member of the OPENFILENAME structure, the magic number 1537 is the resource template ID.

ofn.Flags = OFN_PATHMUSTEXIST | OFN_FILEMUSTEXIST |
            OFN_ENABLETEMPLATE | OFN_NONETWORKBUTTON;
ofn.hInstance = AfxGetResourceHandle();
ofn.lpTemplateName = MAKEINTRESOURCE(1537);

Should there be a mistake in the template, the dialog will not be displayed! There has to be one template per language, so this is not an ideal solution, and every common dialog box, and style of dialog box, that is used would need to be called this way.

Resource Code DLL

This is a "Win32 Dynamic-Link Library", a Resource Only DLL. To create it, do the following:

  • Create a new project, add it to the current workplace, a Win32 Dynamic-Link Library project.
  • Make it "An empty DLL Project"
  • Now click "Finish"
  • To the linker option add \NOENTRY in the "Project Settings", "Linker" pane, "Project Options" section.
  • Copy all the resources from the main program to the new DLL.
  • A useful trick is to create a dummy project, and select the language that you want the resources to be in, then copy the strings, menus etc. across, this does save a bit of time.
  • Possibly changing the properties to the language that matches the DLL, although this is not strictly required.
  • Now "simply" translate the Strings, Menu, Dialog boxes etc.
  • Certain languages will have far longer text strings than English, therefore it is likely that the dialog box layouts may change.

Notes

  • The resource ID values MUST be consistent (i.e. the same) between all the resources language DLLs.
  • You may find that the DLLs do not always compile correctly when doing a build, you may need to do a "Rebuild All" on them.
  • The DLLs are placed into the MultiLang Release or Debug directory after linking.
  • The translations were done on the Internet, so they may not be 100% correct!

Compiling

  • The sample project MUST be compiled using the "Build", "Batch Build" option.
  • The EXE and DLLs are provided in the demo.

History

1.00
  • Original Version
1.01
  • Display today's date in the selected language
  • Use Accelerators
  • Use a Custom Common Dialog

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


Written By
Web Developer
United Kingdom United Kingdom
Ted wrote his first program c. 1972, and has been writing software professionally since 1975. For his sins he has been a user of Visual C++ from version 1.0 days.

On the odd days that he leaves his PC he is into walking in the Peak District, but tends to get waylaid at the lunch time pub.

Comments and Discussions

 
GeneralMy vote of 4 Pin
MuneerMohammed25-Nov-15 22:24
MuneerMohammed25-Nov-15 22:24 
GeneralChanging languages in MDI loses the window list Pin
andwan010-Feb-11 1:59
andwan010-Feb-11 1:59 
QuestionInternationalizing an existing application Pin
krishind_9921-Feb-09 17:35
krishind_9921-Feb-09 17:35 
QuestionWhat about your code with MFC studio 2008 MFC Pin
loeb3-Sep-08 23:50
loeb3-Sep-08 23:50 
GeneralAdd new Language [modified] Pin
der_micha19815-Jun-08 21:49
der_micha19815-Jun-08 21:49 
GeneralMDI Menu Pin
turtleshell29-Nov-06 5:59
turtleshell29-Nov-06 5:59 
QuestionCommon Dialog Issue Pin
Paolo Bozzoli2-Nov-06 3:14
professionalPaolo Bozzoli2-Nov-06 3:14 
AnswerRe: Common Dialog Issue Pin
Ted Ferenc4-Nov-06 21:34
Ted Ferenc4-Nov-06 21:34 
GeneralHelp for hindi text Pin
Ram kotian30-Aug-06 23:13
Ram kotian30-Aug-06 23:13 
GeneralTranslated strings appear like this "???". Pin
p_shetty17-Aug-06 1:09
p_shetty17-Aug-06 1:09 
GeneralRe: Translated strings appear like this "???". Pin
Ted Ferenc17-Aug-06 1:28
Ted Ferenc17-Aug-06 1:28 
GeneralRe: Translated strings appear like this "???". Pin
p_shetty17-Aug-06 19:31
p_shetty17-Aug-06 19:31 
GeneralRe: Translated strings appear like this "???". Pin
p_shetty20-Aug-06 18:19
p_shetty20-Aug-06 18:19 
GeneralRe: Translated strings appear like this "???". Pin
babyprez25-Jan-07 16:53
babyprez25-Jan-07 16:53 
GeneralRe: Translated strings appear like this "???". Pin
Ted Ferenc21-Aug-06 6:17
Ted Ferenc21-Aug-06 6:17 
GeneralRe: Translated strings appear like this "???". Pin
Tarekat17-Nov-06 22:36
Tarekat17-Nov-06 22:36 
GeneralRe: Translated strings appear like this "???". Pin
Hamp Turner29-May-07 9:47
Hamp Turner29-May-07 9:47 
QuestionCustomize common dialog Pin
karthik Tamizhmathi13-Jul-06 2:50
karthik Tamizhmathi13-Jul-06 2:50 
QuestionUser input String and log file Pin
karthik Tamizhmathi12-Jul-06 2:42
karthik Tamizhmathi12-Jul-06 2:42 
AnswerRe: User input String and log file Pin
Ted Ferenc12-Jul-06 6:24
Ted Ferenc12-Jul-06 6:24 
GeneralIn MDI Applications Failed!! Pin
lupyhlp092511-Jan-06 19:32
lupyhlp092511-Jan-06 19:32 
GeneralRe: In MDI Applications Failed!! Pin
Ted Ferenc11-Jan-06 21:43
Ted Ferenc11-Jan-06 21:43 
GeneralRe: In MDI Applications Failed!! Pin
lupyhlp092512-Jan-06 0:02
lupyhlp092512-Jan-06 0:02 
GeneralRe: In MDI Applications Failed!! Pin
Ted Ferenc12-Jan-06 21:33
Ted Ferenc12-Jan-06 21:33 
GeneralImplement In MDI Applications! Pin
kstoychev4-Oct-05 20:39
kstoychev4-Oct-05 20:39 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.