Using the Resource Kit

TX Text Control .NET offers a Resource Kit that enables developers to display TX Text Control's user interface parts in languages other than English and German. English and German are the built-in resources and cannot 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 satellite assembly.

TX Text Control has built-in dialog boxes and error strings. Additionally, it uses resources which are 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 the current system language is also French.

Resource Kit Files

The ResourceKit directory, which is a subdirectory of your TX Text Control.NET main installation directory, contains all necessary files. The TextControl.resx file contains 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 tools of the .NET Framework SDK necessary to build the satellite assembly.

The txtextcontrol.public.snk file contains TX Text Control's public key also 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 installation directory, which must contain all necessary TX Text Control files. The name of the subdirectory must be the two letter language code. For example to install a French satellite assembly create a subdirectoryfr 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\txtextcontrol.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\txtextcontrol.resources,6B83FE9A75CFB638]