Navigation: ABC Library Reference > TranslatorClass > TranslatorClass Methods >====== TranslateString (translate text) ====== | |
TranslateString( text ), VIRTUAL
TranslateString | Translates a text string. |
text | A string constant, variable, EQUATE, or expression containing text to search for. |
The TranslateString method returns the translation value for the specified text. The translation values and macro substitution values are set by the AddTranslation method.
Implementation:
The TranslateString method uses whole word, case sensitive matching to search for text. For example, 'Insert' does not match '&Insert' or 'INSERT' or 'Insert a new Record.' If there is no translation value for the specified text, TranslateString returns text.
The TranslateString method implements the TranslatorClass macro substitution by translating any percent sign (%) delimited text it detects within its own return value.
Return Data Type: STRING
Example:
MyVar STRING('Sound')
PWindow WINDOW('Preferences'),AT(,,89,34),IMM,SYSTEM,GRAY
STRING(@s12),AT(8,30),USE(MyVar)
BUTTON('OK'),AT(57,3,30,10),USE(?OK)
END
CODE
OPEN(PWindow)
MyVar=Translator.TranslateString(MyVar) !translate USE variable contents
ACCEPT
END
See Also: AddTranslation