LanguageID Property

[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]


Returns or sets the language ID for the character.


agent.Characters ("CharacterID").LanguageID [ = LanguageID]

LanguageIDA 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.
 Chinese (Simplified)&H0804Korean&H0412
 Chinese (Traditional)&H0404Norwegian&H0414
 Czech&H0405Portuguese (Portugal)&H0816
 Danish&H0406Portuguese (Brazil)&H0416
 English (British)&H0809Russian&H0419
 English (US)&H0409Slovakian&H041B
 German &H0407Swedish&H041D



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 LanguageID 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