Freigeben über

IAgentCharacterEx::SetLanguageID

  • Artikel

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

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

Legt die Sprach-ID 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, ist dessen Sprach-ID die aktuelle 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 Wortsprechblasentext, die Befehle im Popupmenü des Zeichens und die Spracherkennungs-Engine. Außerdem wird die Standardsprache für die TTS-Ausgabe bestimmt. Um festzustellen, ob eine kompatible Sprach-Engine für die Sprache des Zeichens verfügbar ist, verwenden Sie IAgentCharacterEx::GetSRModeID oder IAgentCharacterEx::GetTTSModeID.

Wenn Sie versuchen, die Sprach-ID für ein Zeichen festzulegen, und die Sprachressourcen des Agents, 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 (z. B. Arabisch oder Hebräisch) unterstützt, aber auf dem System, auf dem Ihre Anwendung ausgeführt wird, keine bidirektionale Unterstützung installiert ist, wird Text in der Wortsprechblase in logischer Statt in der Anzeigereihenfolge angezeigt.

 

Weitere Informationen

IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID