TranslateConfigurationString
Returns the translation of the string entered as a parameter, using the configuration dictionary and referring to the current language in Qubes.
Syntax
TranslateConfigurationString(element[, macro1, value1[,macroN, valueN, ...]])Translate(element[, macro1, value1[,macroN, valueN]])Traduire(element[, macro1, value1[,macroN, valueN]])_(element[, macro1, value1[,macroN, valueN]]) (Qubes 5.6)
macro1 = the first macro to replace in the translated string
value1 = the value replacing the first macro in the translated string
macroN = the nth macro to replace in the translated string
valueN = the value replacing the nth macro in the translated string
Remarks
The macros must have a "¤" (currency sign, also known as the "schmeul" in Qubesian lingo) on each end, in the string you want to translate. To simplify translation work, we recommend naming the variables in English, so the translators of all languages can have an idea of their meanings.
The macros themselves are not translated!
If the element cannot be found in the configuration dictionary, the string will be added to it.
If the element is preceded by a ! (exclamation point), then the character string will not be translated, and the function will return the string without the exclamation point.
If the string of characters needs to be translated by the application's dictionary, use the TranslateApplicationString function.
Examples
Imagine you are using the following translation dictionaries:
| Français | English | Deutsch |
| Lait | Milk | Milch |
| Bonjour ¤NAME¤! | Hello ¤NAME¤! | Guten Tag ¤NAME¤! |
Translate("Lait") = "Milk" in English, "Milch" in GermanTranslate("!Lait") = "Lait" in English and in GermanTranslate("Bonjour ¤NAME¤!", "NAME", "Albert") = "Hello Albert!" in English, "Guten Tag Albert!" in German