ActiveReports 13
Localize the End User Report Designer
ActiveReports 13 > ActiveReports User Guide > How To > Customize, Localize, and Deploy > Localize the End User Report Designer

You can localize all of the UI strings, error messages, and images that appear in the ActiveReports Windows Forms Designer control in included resource files, and alter and run a batch file to localize the assembly.

To localize the Designer control

All of the localization files are located in C:\Program Files (x86)\GrapeCity\ActiveReports 13\Localization.

Specify the culture you want to use in the batch file.

  1. Start Notepad or another text editor as an Administrator.
  2. Open the ARDesigner.bat file and change the Culture value to the culture you want to use.
  3. Ensure that the path in ProgamFilesAssemblyDir is correct for your installation, but do not alter any of the other properties.
  4. Save and close the file.

Localize strings (and images) in the resource files.

  1. Launch your zip program as an Administrator and open the ARDesigner.zip file.
  2. Extract all of the files to
    C:\Program Files (x86)\GrapeCity\ActiveReports 13\Localization.
    An ARDesigner subfolder is created.
  3. In the new folder, open each subfolder and change the strings in each of the *.resx files.
    Tip: Strings are located between <value> and </value> tags in the resource files.
  4. If you want to change the images, rename your localized images to the names of the ones in the Res\Resources subfolder and replace them with your localized images.

Run the batch file as an Administrator.

  1. From the Start menu, type cmd in the text box, and press CTRL + SHIFT + ENTER to open a command prompt as an Administrator.
  2. To change directories, type:
    cd C:\Program Files (x86)\GrapeCity\ActiveReports 13\Localization
    and press Enter.
  3. Type ARDesigner.bat and press Enter to run the file. The NameCompleter.exe application runs, and creates the following.
    • A SatelliteAssembly folder inside the ARDesigner subfolder.
    • A language subfolder with the name of the culture you set inside the SatelliteAssemby folder.
    • A localized GrapeCity.ActiveReports.Design.Win.resources.dll file inside the language subfolder.
  4. Copy the language subfolder and paste it into the Debug folder of your application.
    Note: Before you can distribute or put your localization in the Global Assembly Cache (GAC), you must first send the localized GrapeCity.ActiveReports.Design.Win.resources.dll file to GrapeCity and get it signed with a strong name. Then you can drag the language subfolder with the signed dll file into C:\WINDOWS\ASSEMBLY, or distribute it with your solution.

Test your localized application on a machine that does not share the culture of the localized DLLs.

  1. Add the following code in the form's constructor just before the InitializeComponent method is called.
  2. Replace the "ja" in the example code with the culture you specified in the ARDesigner.bat file.

To write the code in Visual Basic.NET

Visual Basic.NET code. Paste INSIDE the form's constructor just before the InitializeComponent method.
Copy Code
System.Threading.Thread.CurrentThread.CurrentUICulture = New System.Globalization.CultureInfo("ja")

To write the code in C#

C# code. Paste INSIDE the form's constructor just before the InitializeComponent method.
Copy Code
System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("ja");
See Also