Localizing a Wizard to Multiple Languages

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Localizing a Wizard to Multiple Languages.

You can create a wizard in any language for which Visual Studio provides support. By default, when you install Visual Studio, it identifies the locale from the registry and provides the appropriate templates for that locale.

Visual Studio uses language IDs to identify the language support a wizard requires. By default, the language ID is set to the decimal value of the registry entry HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage. If the wizard can find no language entry, it defaults to English (1033).

Note

For a list of decimal language values, see Wizard Support for Other Languages.

The language ID is specified as a custom parameter in the .vsz file in the paths where the HTML files and the Template files reside.

You should specify paths for each language for which you provide an .htm file.

Example

Setting the following custom parameters in the .vsz file indicate that you are providing HTML in English (1033), Japanese (1041), and German (1031):

Param="START_PATH\HTML\1033"  
Param="START_PATH\HTML\1041"  
Param="START_PATH\HTML\1031"  
Param="START_PATH\Templates\1033"  
Param="START_PATH\Templates\1041"  
Param="START_PATH\Templates\1031"  

Setting the above custom parameters sets up your wizard directory structure as follows:

MyWizard1  
   HTML  
      1033  
         default.htm  
         myEnglishHTML.htm  
      1041  
         default.htm  
         myJapaneseHTML.htm  
      1031  
         default.htm  
         myGermanHTML.htm  
   Templates  
      1033  
         stdafx.h  
         stdafx.cpp  
      1041  
         stdafx.h  
         stdafx.cpp  
      1031  
         stdafx.h  
         stdafx.cpp  
   Images  
      HtmlPage1.bmp  
      HtmlPage2.jpg  
   Scripts  
      Default.js  

See Also

Files Created for Your Wizard
Custom Wizard
Creating a Custom Wizard
Designing a Wizard
Custom Parameters in the Wizard .Vsz File