IAgentCharacterEx：：SetLanguageID

[從 Windows 7 開始，Microsoft Agent 已被取代，而且在後續版本的 Windows 中可能無法使用。]

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

設定字元的語言識別項集。

• 傳回S_OK，表示作業成功。

langID

字元的語言識別項設定。

Long 整數，指定字元的語言識別項。 字元的語言識別項 (LANGID) 是由 Windows 定義的 16 位值，由主要語言識別項和次要語言識別項所組成。 您可以針對指定的語言使用下列值。 如需詳細資訊，請參閱平臺 SDK 檔。

語言	識別碼	語言	識別碼
阿拉伯文 ()	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
Hebrew	0x040D	土耳其文	0x041F
匈牙利文	0x040E

 

如果您未設定字元的語言識別項，如果已安裝對應的 Agent 語言 DLL，其語言識別項將會是目前的系統語言識別項;否則，字元的語言將會是英文 (美國) 。

此屬性也會決定文字批註方塊文字的語言、字元快顯功能表中的命令，以及語音辨識引擎。 它也會決定 TTS 輸出的預設語言。 若要判斷字元的語言是否有相容的語音引擎，請使用 IAgentCharacterEx：：GetSRModeID 或 IAgentCharacterEx：：GetTTSModeID。

如果您嘗試設定字元的語言識別項和 Agent 語言資源、字碼頁或語言識別項的顯示字型無法使用，Agent 會傳回錯誤，而且字元的語言識別項會維持在其最後一個設定。 如果語言沒有相符的語音引擎，則設定此屬性不會傳回錯誤。

這個屬性只適用于您用戶端應用程式的字元使用;此設定不會影響用戶端應用程式字元或其他字元的其他用戶端。

注意

如果您將字元的語言識別項設定為支援雙向文字的語言 (，例如阿拉伯文或希伯來文) ，但執行應用程式的系統並未安裝雙向支援，文字就會以邏輯而非顯示順序出現在文字批註方塊中。

 

另請參閱

IAgentCharacterEx：GetLanguageID、 IAgentCharacterEx：：GetSRModeID、 IAgentCharacterEx：：GetTTSModeID