IAgentCharacterEx::SetLanguageID
[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない可能性があります。]
HRESULT SetLanguageID(
long langID // language ID setting of character
);
文字に設定された言語 ID を設定します。
- 操作が成功したことを示すS_OKを返します。
-
langIDを する
-
文字の言語 ID 設定。
文字の言語 ID を指定する長整数。 文字の言語 ID (LANGID) は、Windows によって定義される 16 ビット値であり、プライマリ言語 ID と第 2 言語 ID で構成されます。 指定した言語には、次の値を使用できます。 詳細については、プラットフォーム 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 |
ヘブライ語 | 0x040D | トルコ語 | 0x041F |
ハンガリー語 | 0x040E |
文字の言語 ID を設定しない場合、対応するエージェント言語 DLL がインストールされている場合、その言語 ID は現在のシステム言語 ID になります。それ以外の場合、文字の言語は英語 (米国) になります。
このプロパティは、吹き出しテキストの言語、文字のポップアップ メニューのコマンド、音声認識エンジンも決定します。 また、TTS 出力の既定の言語も決定します。 文字の言語で使用できる互換性のある音声エンジンがあるかどうかを確認するには、IAgentCharacterEx::GetSRModeID使用するか、IAgentCharacterEx::GetTTSModeIDをします。
文字の言語 ID を設定しようとして、エージェント言語リソース、コード ページ、または言語 ID の表示フォントを使用できない場合、エージェントはエラーを返し、文字の言語 ID は最後の設定のままです。 言語に一致する音声エンジンがない場合、このプロパティを設定してもエラーは返されません。
このプロパティは、クライアント アプリケーションによる文字の使用にのみ適用されます。この設定は、文字の他のクライアントやクライアント アプリケーションの他の文字には影響しません。
手記
文字の言語 ID を双方向テキスト (アラビア語やヘブライ語など) をサポートする言語に設定したが、アプリケーションを実行しているシステムに双方向サポートがインストールされていない場合、テキストは表示順序ではなく論理的にワード バルーンに表示されます。
関連項目
IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID