IAgentCharacterEx::SetLanguageID

[从 Windows 7 开始弃用 Microsoft 代理,在后续版本的 Windows 中可能不可用。

HRESULT SetLanguageID(
   long langID  // language ID setting of character
); 

设置字符的语言 ID 集。

  • 返回S_OK以指示操作成功。

langID

字符的语言 ID 设置。

一个长整数,指定字符的语言 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,则安装相应的代理语言 DLL 时,其语言 ID 将为当前系统语言 ID;否则,字符的语言将为英语 (美国) 。

此属性还确定单词气球文本的语言、字符弹出菜单中的命令和语音识别引擎。 它还确定 TTS 输出的默认语言。 若要确定是否有兼容的语音引擎可用于字符的语言,请使用 IAgentCharacterEx::GetSRModeIDIAgentCharacterEx::GetTTSModeID

如果尝试为字符和代理语言资源设置语言 ID、代码页或语言 ID 的显示字体不可用,代理将返回错误,并且字符的语言 ID 仍保留在其最后一个设置中。 如果语言没有匹配的语音引擎,则设置此属性不会返回错误。

此属性仅适用于客户端应用程序对字符的使用;此设置不会影响客户端应用程序的字符或其他字符的其他客户端。

注意

如果将字符的语言 ID 设置为支持双向文本 (的语言(如阿拉伯语或希伯来语) ),但运行应用程序的系统没有安装双向支持,则文本将以逻辑而不是显示顺序显示在单词气球中。

 

另请参阅

IAgentCharacterEx:GetLanguageIDIAgentCharacterEx::GetSRModeIDIAgentCharacterEx::GetTTSModeID