Using the Resource Kit

TX Text Control .NET offers a Resource Kit that enables developers to display TX Text Control'suser interface parts in languages other than English and German. English and German are the built-in resources andcannot be changed. All other languages are possible with the satellite assembly mechanism the prefered mechanism for localization within the .NET Framework. The following describes how to build a satelliteassembly.

TX Text Control Resources

TX Text Control has built-in dialog boxes and error strings. Additionally, it uses resources whichare part of the .NET Framework such as the Load File... or Save File...dialog boxes. The language used for the parts of the .NET Framework depend on the current system language. Therefore,the built-in Text Control resources follow this mechanism and also depend on the current system language.For example, if a developer builds a satellite assembly for French, the French resources are only loaded if thecurrent system language is also French.

Resource Kit Files

The ResourceKit directory, which is a subdirectory of your TX Text Control.NETmain installation directory, contains all necessary files. The TextControl.resx filecontains all built-in resources in a human readable XML format. All parts of dialog boxes appear as strings.

The buildres.bat file is a command line batch file that calls the command line toolsof the .NET Framework SDK necessary to build the satellite assembly.

The txtextcontrol.public.snk file contains TX Text Control's public keyalso necessary to build the satellite assembly.

Building the Satellite Assembly

To build a satellite assembly for TX Text Control, perform the following tasks:

1. Install at least the .NET Framework SDK.

2. Translate all the text resources in the TextControl.resx file. The text resources are the contents of the value tags.

3. Call the buildres.bat batch file with the two letter language code specified through ISO 639 as parameter (for example French: buildres fr). The batch process builds the satellite assembly file txtextcontrol.resources.dll.

Installing the Satellite Assembly

The newly created assembly must be located in a subdirectory of your application's installationdirectory, which must contain all necessary TX Text Control files. The name of the subdirectory must be thetwo letter language code. For example to install a French satellite assembly create a subdirectory fr and copy txtextcontrol.resources.dll to this directory.

Additionally, create the following registry key to ensure that the .NET Framework uses custom builds of satellite assemblies with your application:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\StrongName\Verification  xtextcontrol.resources,6B83FE9A75CFB638]

The following registry key must be created to use custom builds of satellite assemblies in 32-bit applications on a 64-bit system:

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\StrongName\Verification      xtextcontrol.resources,6B83FE9A75CFB638]