# Localization and Resource Kit > Localize TX Text Control for WPF: German satellite assemblies from the NuGet package, other languages via the Resource Kit, ribbon texts and icons by culture. - **Product:** TX Text Control .NET for WPF - **Section:** Documentation - **Kind:** Topic - **Path:** TX Text Control .NET for WPF > Document Editor > Ribbon and UI > Localization and Resource Kit - **2165 words** - **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/localization/ - **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/localization/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/localization/llms-full.txt --- Which language do the dialog boxes and messages of TX Text Control .NET for WPF speak? English or German, depending on the language of the system, and any other language for which you build a satellite assembly with the Resource Kit. Read on for the German resources in the NuGet package, the Resource Kit steps, and the `ResourceProvider` calls that give your own WPF controls the ribbon's texts and icons in a chosen language. Only the user interface is meant here. The language of the document text, which spell checking uses, is a formatting attribute set with [LanguageDialog](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/textcontrol/languagedialog-method/llms-full.txt) or in code; see [Spell Checking](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/spell-checking/llms-full.txt). ### English, German and Satellite Assemblies The built-in dialog boxes and the error strings of TX Text Control are .NET string resources. English is built into the assemblies. German comes as *satellite assemblies*, assemblies that hold only the resources of one language, in the folder *lib/net8.0/de* of the package `TXTextControl.TextControl.WPF.SDK`: - *TXTextControl.resources.dll* for *TXTextControl.dll* - *TXDocumentServer.resources.dll* for *TXDocumentServer.dll* - *TXDrawing.resources.dll* for *TXDrawing.dll* - *TXBarcode.resources.dll* for *TXBarcode.dll* The English and German resources are fixed; other languages are added, not changed. The language is chosen by the current system language, the same way .NET chooses the language of its own file dialog boxes. With a German system language and the folder *de* next to the TX Text Control assemblies, the dialog boxes and messages are German. For a language without a satellite assembly, they stay English, and a satellite assembly for another language, such as French, is loaded only on a system whose language is French. The texts of the ribbon are resources too. [ResourceProvider](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/resourceprovider/llms-full.txt) returns them in the language you pass, as the last section shows. ### Deploy the Folder de The build copies *de* into the output directory of a .NET project. Ship it in the same place: ```text \YourApplication.exe \TXTextControl.dll \TXTextControl.WPF.dll \de\TXTextControl.resources.dll \de\TXDocumentServer.resources.dll \de\TXDrawing.resources.dll \de\TXBarcode.resources.dll ``` A deployment without this folder shows English dialog boxes on German systems too. [Managed Assemblies and Native Libraries](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/deployment/assemblies/llms-full.txt) describes the other files. ### Build a Satellite Assembly With the Resource Kit The setup installs the Resource Kit in the *ResourceKit* folder of the installation directory, as [Installing the Product](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/installation/setup/llms-full.txt) lists. Its files: | File | Contents | |---|---| | *TextControl.resx* | The built-in resources in XML. The texts are the contents of the `value` elements | | *buildres.bat* | Calls the command line tools of the .NET Framework SDK that build the satellite assembly | | *txtextcontrol.public.snk* | The public key of TX Text Control, which the build needs | A 2025 blog article, [Changing the Language in the Angular Document Editor Using the Resource Kit](https://www.textcontrol.com/blog/2025/03/05/changing-the-language-in-the-angular-document-editor-using-the-resource-kit/), shows that *TextControl.resx* also holds ribbon texts such as the name of the **Reporting** tab, and that other *.resx* files such as *TXBarcode.resx* can be translated the same way. To build and install a French satellite assembly: 1. Install the .NET Framework SDK. 2. Translate the contents of the `value` elements in *TextControl.resx*. Leave the resource names unchanged. 3. In the *ResourceKit* folder, run the batch file with the ISO 639 two-letter code: ```powershell .\buildres.bat fr ``` The result is *txtextcontrol.resources.dll*. 4. In the application folder that holds the TX Text Control files, create the subfolder *fr* and copy the file into it. 5. On every machine, create the registry key that lets the .NET Framework use your own build of the satellite assembly: ```text HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\StrongName\Verification\txtextcontrol.resources,6B83FE9A75CFB638 ``` For a 32-bit application on 64-bit Windows, add it below `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\StrongName\Verification` as well. Satellite assemblies of *TXBarcode*, *TXDocumentServer* and *TXDrawing* get keys of the same form, such as `TXDrawing.resources,6B83FE9A75CFB638`. These steps come from the documentation of the Resource Kit, which is written for the .NET Framework: the SDK tools and the registry key both belong to it. No source describes a separate procedure for .NET 8 or higher. The .NET Framework case of a WPF application is covered in [Deploying .NET Framework Applications](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/deployment/dotnet-framework/llms-full.txt). ### Texts and Icons for Your Own Controls The text methods of the `ResourceProvider`, listed in [Give Your Buttons the Built-in Icons](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/custom-tabs/#give-your-buttons-the-built-in-icons), take the identifier of a ribbon item and an optional `CultureInfo` for the language of the result. Icons can depend on the language as well. `TXITEM_Bold`, `TXITEM_Italic` and `TXITEM_Underline` have small icons for English, French, German and Spanish, selected by the [Culture](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/resourceprovider-imagesourcesettings/culture-property/llms-full.txt) property of [ImageSourceSettings](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/resourceprovider-imagesourcesettings/llms-full.txt). The default culture is `CultureInfo.CurrentUICulture`; a culture without its own icon gets the English one. A toggle button in *MainWindow.xaml*: ```xml ``` gets the French icon and the tooltip of the ribbon's bold button in *MainWindow.xaml.cs*: ```csharp using System.Globalization; using System.Windows; using System.Windows.Controls; using TXTextControl.WPF; public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); Loaded += MainWindow_Loaded; } private void MainWindow_Loaded(object sender, RoutedEventArgs e) { CultureInfo french = new CultureInfo("fr"); string identifier = RibbonFormattingTab.RibbonItem.TXITEM_Bold.ToString(); ResourceProvider.ImageSourceSettings settings = new ResourceProvider.ImageSourceSettings(); settings.Culture = french; boldButton.Content = new System.Windows.Controls.Image { Source = ResourceProvider.GetSmallIcon(identifier, this, settings) }; boldButton.ToolTip = ResourceProvider.GetToolTipTitle(identifier, french); } } ``` The code works as follows: - [RibbonFormattingTab.RibbonItem](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/ribbonformattingtab/ribbonitem-enumeration/llms-full.txt) lists the items of the formatting tab; `ToString` turns a value into the identifier. - `ImageSourceSettings.Culture` selects the French bold icon, and [GetSmallIcon](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/resourceprovider/getsmallicon-method/llms-full.txt) creates it as a `BitmapSource` in the resolution of the window. - `GetToolTipTitle` returns the title of the tooltip in French only if a French satellite assembly built with the Resource Kit is deployed; otherwise it returns the English title. ### Next Steps - [Built-in Dialog Boxes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/dialog-boxes/llms-full.txt): the dialog boxes whose texts are localized. - [Right-to-Left UI](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/right-to-left/llms-full.txt): windows for Arabic and Hebrew users. - [Styles, Resources, and Themes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/themes/llms-full.txt): icons and colors of the control. - [Managed Assemblies and Native Libraries](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/deployment/assemblies/llms-full.txt): what to deploy. --- ## Nearby - **Previous:** [Styles, Resources, and Themes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/themes/llms-full.txt) - **Next:** [Right-to-Left UI](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/ribbon-ui/right-to-left/llms-full.txt)