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