Platform SDK: Agent

LanguageID Property

Description
Returns or sets the language ID for the character.
Syntax
agent.Characters ("CharacterID").LanguageID [ = LanguageID]
Part Description
LanguageID A Long integer specifying the language ID for the character. The language ID (LANGID) for a character is a 16-bit value defined by Windows, consisting of a primary language ID and a secondary language ID. The following examples are values for languages supported by Microsoft Agent. To determine the value for other languages, see the Platform SDK documentation.
  Arabic &H0401 Italian &H0410
  Basque &H042D Japanese &H0411
  Chinese (Simplified) &H0804 Korean &H0412
  Chinese (Traditional) &H0404 Norwegian &H0414
  Croatian &H041A Polish &H0415
  Czech &H0405 Portuguese (Portugal) &H0816
  Danish &H0406 Portuguese (Brazil) &H0416
  Dutch &H0413 Romanian &H0418
  English (British) &H0809 Russian &H0419
  English (US) &H0409 Slovakian &H041B
  Finnish &H040B Slovenian &H0424
  French &H040C Spanish &H0C0A
  German &H0407 Swedish &H041D
  Greek &H0408 Thai &H041E
  Hebrew &H040D Turkish &H041F
  Hungarian &H040E    

Remarks

If you do not set the LanguageID for the character, its language ID will be the current system language ID if the corresponding Agent language DLL is installed, otherwise, the character's language will be English (US).

This property also determines the language for word balloon text, the commands in the character's pop-up menu, and the speech recognition engine. It also determines the default language for TTS output.

If you try to set the language ID for a character and the Agent language DLL for that language is not installed or a display font for the language ID is not available, Agent raises an error and LanguageID remains at its last setting.

Setting this property does not raise an error if there are no matching speech engines for the language. To determine if there is a compatible speech engine available for the LanguageID, check SRModeID or TTSModeID. If you do not set LanguageID, it will be set to the user default language ID setting.

This property applies only to your client application's use of the character; the setting does not affect other clients of the character or other characters of your client application.

Note  If you set LanguageID to a language that supports bidirectional text (such as Arabic or Hebrew), but the system running your application does not have bidirectional support installed, text in the word balloon will appear in logical rather than display order.

See Also

SRModeID property, TTSModeID property