IBtm::SetLanguage() method information

M&M FDT 1.2.1 Online Specification
IBtm::SetLanguage() method information

Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations

4.7.1.12 IBtm::SetLanguage()

This method can be called in the states:

HRESULT SetLanguage (
[in] int languageId,
[out, retval] VARIANT_BOOL* result
);

Description:

For description of this method, refer to method IDtm::SetLanguage().

Parameters:

languageId

Return Value:

result

TRUE Language supported. All human readable outputs will use the required language FALSE Language not supported

Behavior:

Comments:

-/-

Comments from fdtFAQ Forum:

Thomas Weller
created on 2006-11-10, last updated on 2006-11-10

The definition of SetLanguage() has been taken from FDT 1.2. Even in FDT 1.2 it was defined that SetLanguage() cannot be called in 'going online' and 'going offline', but in 'communication set'. But a FDT 1.2 frame application cannot distinguish between 'communication set' and 'going online' / 'going offline'. Therefore in FDT 1.2 the allowed states should already have included these two states. That's why I marked them as callable on this website. And actually I think even the 'online' state should allow to let SetLanguage() to be called. Imagine a DTM which is online but does not show a user interface yet. It is possible that the user cannot even distinguish between 'communication set' and 'online' The user then switches the language of the frame (which will inform the DTM) and opens a user interface. For the user it is totally unclear why the language was not changed. Thus I marked 'online' as a state allowing to call SetLanguage().

© by M&M Software GmbH, parts of this website taken from FDT Interface Specification Version 1.2.1, © by FDT Group, AISBL.
This website is published for support of M&M products as granted in license conditions, chapter 2.1.
Last updated 2015-02-05 15:17
Email: FDT Technical Support Line.