ActiveReports 6 Online Help
Localize the Viewer Control

To localize the viewer control

  1. In Windows Explorer, navigate to C:\Program Files\GrapeCity\ActiveReports 6\Localization (on a 64-bit Windows operating system, navigate to C:\Program Files (x86)\GrapeCity\ActiveReports 6\Localization).
  2. Edit the Viewer.bat file:
    1. Right-click the Viewer.bat file and select Edit.
    2. Change the culture in the line set Culture="en-Us" to the culture you want to use. For your convenience, here is a list of predefined .NET Cultures.
    3. Ensure that the ProgamFilesDDPath is correct.
      Caution: Do not change the ProjectName, dllName, msDir, or BaseNamespace.
    4. Save and close the Viewer.bat file.
  3. Change strings in the resource files:
    1. Double-click the Viewer.zip file to open it.
    2. Extract all of the files to C:\Program Files\GrapeCity\ActiveReports 6\Localization (on a 64-bit Windows operating system, extract the files to C:\Program Files (x86)\GrapeCity\ActiveReports 6\Localization). A Viewer subfolder is created.
    3. In the new Viewer folder's Res subfolder, open each of the four *.resx files and change the strings as needed.
    4. If you want to change any of the images, rename your localized images to the names of the ones in the Res\Resources subfolder and replace them with your localized images.
  4. Back in the main Localization folder, double-click the Viewer.bat file to run it. The NameCompleter.exe application runs, and creates:
    • A SatelliteAssembly folder inside the Viewer folder.
    • A language subfolder with the same name as the culture you set in the Viewer.bat file inside the SatelliteAssemby folder.
    • A localized ActiveReports.Viewer6.resources.dll file inside the language subfolder.

    Note: The Viewer.bat file copies the language subfolder with the ActiveReports.Viewer6.resource.dll to
    the C:\Program Files\Common Files\GrapeCity\ActiveReports 6\ folder (on a 64-bit Windows operating system, the C:\Program Files (x86)\Common Files\GrapeCity\ActiveReports 6\ folder). If you get a warning message when running the Viewer.bat file, then you should use the administrator permissions for the Viewer.bat file.

    Run the Viewer.bat file as Administrator

    Log in as an Administrator

  5. Copy the language subfolder and paste it into the Debug folder of your application.

Note: If you want to put your localization in the Global Assembly Cache (GAC), you must first send the localized ActiveReports.Viewer6.resources.dll file to GrapeCity and get it signed. Then you can drag the language subfolder with the signed dll file into C:\WINDOWS\ASSEMBLY.

Since the UAC in Vista and Windows7 prevents drag and drop registry to the GAC, we recommend that users of these operating systems run the Gacutil.exe as described on MSDN.

To test your localized application on a machine that does not share the culture of the localized dll

  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 specified in the Viewer.bat file.

To write the code in Visual Basic.NET

To write the code in C#

See Also