GetLanguageTextW (FUN)

FUNCTION GetLanguageTextW : ReturnValues

This function returns the language specific text of a textlist as WSTRING.

Note

The desired language must be loaded with CmpDynamicText.DynamicTextLoadLanguage(sLanguage) before the function GetLanguageTextW is called. For performance reasons, the language should not be loaded/unloaded cyclically. The best way is to load the language after the application has been initialized or when a language change is necessary. The language should be unloaded with CmpDynamicText.DynamicTextUnloadLanguage(sLanguage) when the language texts are not needed anymore.

To retrieve real unicode strings the parameter “Use Unicode strings” must be activated in the visualization manager.

InOut:

Scope	Name	Type	Comment
Return	GetLanguageTextW	ReturnValues	Possible last error values: ERR_INSUFFICIENT_BUFFER ERR_PARAMETER ERR_FAILED ERR_OK see ReturnValues (GVL) where possible error reasons are described.
Inout Const	sTextList	STRING	The textlist name
	sTextIndex	STRING	The textlist id
	sLanguage	STRING	In which language the text should be returned
Input	pwsText	POINTER TO WSTRING	The buffer where the result text should be returned
	diSize	DINT	The size of the parameter pwsText in byte (SIZEOF() can be used)
Output	bDefaultText	BOOL	Indicates if the default text is used