::XllGetTranslatedString

Translates a string containing resource IDs, for the language of the Excel version

[C++]
CString XllGetTranslatedString(
   const char* pszIn
);

Parameters

pszIn

input string, which may contain numeric resource string identifiers. See Remarks below.

Return value

If the function succeeds, the translated string will be returned. If it fails, then an untranslated or partially translated string will be returned.

Remarks

This function attempts to replace the resource string IDs in the input string with resource strings loaded from the current resource file. The resource file searched will be that returned by XllGetStringResourceHandle). The language used will be either the current user preference (as returned by GetThreadLocale()) or the language of the Excel version (as returned by XllGetExcelLanguageID).

String identifiers should be in one of the following forms:

• Integers preceded by a # sign, e.g.: #123, which will be replaced by strings in the user's language.
• Integers preceded by "#@", e.g.: #@123, which will be replaced by strings in the language of the Excel version that is running.

See String substitutions for more information.

This function calls XllTranslateString and ignores errors.

Requirements

Header: xllres.h

See Also

Global resource functions | XllTranslateString