How to modify or translate messages in compiled workbook
The custom resources dictionary allows you to modify or translate some of the default messages in the compiled workbook to another language.
The custom resources dictionary is a text file encoded in UTF-8. It contains some of the text resources which are used in the compiled EXE file to show messages.
You can create your own resources dictionaries for different languages.
To create a custom resources dictionary, you need to copy the ‘ENGLISH.dic’ file from the DoneEx XCell Compiler installation folder to any location where you are going to keep it and then rename the file.
Open this newly copied dictionary file in Microsoft NOTEPAD.
Content of the dictionary file has a ini-file structure. Each text resource is written as a key/value pair connected by the ‘=’ assignment sign on a single line: ‘MNEMO_CODE_KEY=Text value’.
In the image above, MNEMO_CODE_KEY is highlighted with red and the text value is highlighted with green.
You have to keep the MNEMO_CODE_KEY (left side, before the assignment ‘=’ sign) unchanged.
If you want to change a text value of a resource, then you need to rewrite the part to the right of the ‘=’ assignment sign with your content. The whole text value should be written in a single line without starting a new line. Some of the text resources may be shown in a multiple lines message box. To start a new line in the text you need to insert the ‘\n’ symbol combination. While displaying, ‘\n’ will be converted to a new line transfer.
Example of resource record structure:
MNEMO_CODE_KEY=Text value\nThis part of text will be shown on new line.
If you want to keep some text resource empty then you need to use “\r” text (without quotas) as the value of such resource.
Like: MNEMO_CODE_KEY=\r
You can rewrite the text values for mnemo codes existing in default ENGLISH.dic file. If you add some other mnemo code and a text value for it then such text resources will be ignored.
Custom resources dictionary files should be encoded in UTF-8, so when you ‘Save As’ in Notepad make sure that you have selected UTF-8 encoding.
To use the custom resources dictionary you need to click on the ‘Custom resources dictionary’ link on the compilation form and select the dictionary you want to use.
Related Articles: