| **Navigation:**  [[abc library reference.htm|ABC Library Reference]] > TranslatorClass > TranslatorClass Methods >====== TranslateString (translate text) {{c6h0009.jpg|C6H0009.jpg}} ====== | [[translatecontrols  translate text for range of controls .htm|{{btn_prev_n.gif|Previous page}}]][[abc library reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[translatewindow  translate text for a window .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**TranslateString(**// text// **), VIRTUAL**

{{blk2blue.jpg|blk2blue.jpg}}

| **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  add translation pairs .htm|AddTranslation]]