IAgentCharacterEx::SetLanguageID
[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr verfügbar.]
HRESULT SetLanguageID(
long langID // language ID setting of character
);
Legt den Sprach-ID-Satz für das Zeichen fest.
- Gibt S _ OK zurück, um anzugeben, dass der Vorgang erfolgreich war.
-
Langid
-
Die Sprach-ID-Einstellung für das Zeichen.
Eine long-Ganzzahl, die die Sprach-ID für das Zeichen angibt. Die Sprach-ID (LANGID) für ein Zeichen ist ein von Windows definierter 16-Bit-Wert, der aus einer primären Sprach-ID und einer sekundären Sprach-ID besteht. Sie können die folgenden Werte für die angegebenen Sprachen verwenden. Weitere Informationen finden Sie in der Dokumentation zum Platform SDK.
| Sprache | ID | Sprache | ID |
|---|---|---|---|
| Arabisch (Saudi) | 0x0401 | Italienisch | 0x0410 |
| Baskisch | 0x042d | Japanisch | 0x0411 |
| Chinesisch (vereinfacht) | 0x0804 | Koreanisch | 0x0412 |
| Chinesisch (traditionell) | 0x0404 | Norwegisch | 0x0414 |
| Kroatisch | 0x041A | Polnisch | 0x0415 |
| Tschechisch | 0x0405 | Portugiesisch (Portugal) | 0x0816 |
| Dänisch | 0x0406 | Portugiesisch (Brasilien) | 0x0416 |
| Niederländisch | 0x0413 | Rumänisch | 0x0418 |
| Englisch (Großbritannien) | 0x0809 | Russisch | 0x0419 |
| Englisch (USA) | 0x0409 | Slowakisch | 0x041B |
| Finnisch | 0x040B | Slowenisch | 0x0424 |
| Französisch | 0x040C | Spanisch | 0x0C0A |
| Deutsch | 0x0407 | Schwedisch | 0x041D |
| Griechisch | 0x0408 | Thailändisch | 0x041E |
| Hebräisch | 0x040D | Türkisch | 0x041F |
| Ungarisch | 0x040E |
Wenn Sie die Sprach-ID für das Zeichen nicht festlegen, entspricht die Sprach-ID der aktuellen Systemsprach-ID, wenn die entsprechende Agent-Sprach-DLL installiert ist. Andernfalls ist die Sprache des Zeichens Englisch (USA).
Diese Eigenschaft bestimmt auch die Sprache für den Text der Sprachsprechblasen, die Befehle im Popupmenü des Zeichens und die Spracherkennungs-Engine. Außerdem wird die Standardsprache für die TTS-Ausgabe bestimmt. Verwenden Sie IAgentCharacterEx::GetSRModeID oder IAgentCharacterEx::GetSRModeID oder IAgentCharacterEx::GetTTSModeID,um zu ermitteln, ob eine kompatible Sprach-Engine für die Sprache des Zeichens verfügbar ist.
Wenn Sie versuchen, die Sprach-ID für ein Zeichen und die Agent-Sprachressourcen festzulegen, die Codepage oder eine Anzeigeschriftart für die Sprach-ID nicht verfügbar ist, gibt der -Agent einen Fehler zurück, und die Sprach-ID des Zeichens bleibt bei der letzten Einstellung. Das Festlegen dieser Eigenschaft gibt keinen Fehler zurück, wenn keine übereinstimmenden Sprach-Engines für die Sprache vorhanden sind.
Diese Eigenschaft gilt nur für die Verwendung des Zeichens durch Ihre Clientanwendung. Die Einstellung wirkt sich nicht auf andere Clients des Zeichens oder anderer Zeichen Ihrer Clientanwendung aus.
Hinweis
Wenn Sie die Sprach-ID des Zeichens auf eine Sprache festlegen, die bidirektionalen Text unterstützt (z. B. Arabisch oder Hebräisch), aber auf dem System, auf dem Ihre Anwendung ausgeführt wird, keine bidirektionale Unterstützung installiert ist, wird Text im Wortsprechblasen in logischer statt in der Anzeigereihenfolge angezeigt.
Weitere Informationen
IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID