::XllTranslateStringA

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

BOOL XllTranslateStringA(
   const char* pszIn,
   CStringA& strOut
);

Parameters

pszIn

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

strOut

If the function succeeds, the translated string will be loaded into this variable. If it fails, then an untranslated or partially translated string will be placed here.

Return Value

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.

String substitution by XLL+ functions

The functions, macros and data members that accept and translate resource ID strings are listed below.

Requirements

Header: xllres.h

See Also

Global resource functions