Localizing a Wizard to Multiple Languages

  • Article

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

Tasks

Creating a Custom Wizard

Reference

Custom Wizard

Custom Parameters in the Wizard .Vsz File

Concepts

Files Created for Your Wizard

Designing a Wizard