IAgentCharacterEx：：SetLanguageID
[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]
HRESULT SetLanguageID(
long langID // language ID setting of character
);
设置字符的语言 ID 集。
- 返回指示操作成功的S_OK。
-
langID
-
字符的语言 ID 设置。
一个 Long 整数，指定字符的语言 ID。 字符的语言 ID (LANGID) 是 Windows 定义的 16 位值，由主要语言 ID 和辅助语言 ID 组成。 可以将以下值用于指定语言。 有关详细信息，请参阅平台 SDK 文档。
| 语言 | ID | 语言 | ID |
|---|---|---|---|
| 阿拉伯文 (沙特) | 0x0401 | 意大利语 | 0x0410 |
| 巴斯克语 | 0x042d | 日语 | 0x0411 |
| 中文(简体) | 0x0804 | 韩语 | 0x0412 |
| 中文(繁体) | 0x0404 | 挪威语 | 0x0414 |
| 克罗地亚语 | 0x041A | 波兰语 | 0x0415 |
| 捷克语 | 0x0405 | 葡萄牙语(葡萄牙) | 0x0816 |
| 丹麦语 | 0x0406 | 葡萄牙语（巴西） | 0x0416 |
| 荷兰语 | 0x0413 | 罗马尼亚语 | 0x0418 |
| 英语(英国) | 0x0809 | 俄语 | 0x0419 |
| 英语(美国) | 0x0409 | 斯洛伐克语 | 0x041B |
| 芬兰语 | 0x040B | 斯洛文尼亚语 | 0x0424 |
| 法语 | 0x040C | 西班牙语 | 0x0C0A |
| 德语 | 0x0407 | 瑞典语 | 0x041D |
| 希腊语 | 0x0408 | 泰语 | 0x041E |
| 希伯来语 | 0x040D | 土耳其语 | 0x041F |
| 匈牙利语 | 0x040E |
如果未设置字符的语言 ID，则其语言 ID 将是当前系统语言 ID（如果安装了相应的代理语言 DLL）;否则，字符的语言将是英语 (美国) 。
此属性还确定单词气球文本的语言、字符弹出菜单中的命令以及语音识别引擎。 它还确定 TTS 输出的默认语言。 若要确定是否有适用于字符语言的兼容语音引擎，请使用 IAgentCharacterEx：：GetSRModeID 或 IAgentCharacterEx：：GetTTSModeID。
如果尝试设置字符的语言 ID 和代理语言资源、代码页或语言 ID 的显示字体不可用，代理将返回错误，并且字符的语言 ID 将保留其最后一个设置。 如果语言没有匹配的语音引擎，则设置此属性不会返回错误。
此属性仅适用于客户端应用程序对 字符的使用;设置不会影响客户端应用程序的字符或其他字符的其他客户端。
注意
如果将字符的语言 ID 设置为支持双向文本 (（如阿拉伯语或希伯来语) ）的语言，但运行应用程序的系统未安装双向支持，则文本将以逻辑顺序显示在单词气球中，而不是显示顺序。
另请参阅
IAgentCharacterEx：GetLanguageID、 IAgentCharacterEx：：GetSRModeID、 IAgentCharacterEx：：GetTTSModeID