IAgentCharacterEx::GetLanguageID
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
HRESULT GetLanguageID(
long * plangID // address of language ID setting
);
Recupera o conjunto de IDs de idioma para o caractere.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
plangID
-
Endereço de uma variável que recebe a configuração de ID do idioma para o caractere.
Um inteiro Long especificando a ID do idioma para o caractere. A ID de idioma (LANGID) para um caractere é um valor de 16 bits definido pelo Windows, que consiste em uma ID de idioma primária e uma ID de idioma secundária. Os exemplos a seguir são valores para alguns idiomas. Para determinar os valores de outros idiomas, consulte a documentação do SDK da plataforma.
| Idioma | ID | Idioma | ID |
|---|---|---|---|
| Árabe (saudita) | 0x0401 | Italiano | 0x0410 |
| Basco | 0x042d | Japonês | 0x0411 |
| Chinês (Simplificado) | 0x0804 | Coreano | 0x0412 |
| Chinês (Tradicional) | 0x0404 | Norueguês | 0x0414 |
| Croata | 0x041A | Polonês | 0x0415 |
| Tcheco | 0x0405 | Português (Portugal) | 0x0816 |
| Dinamarquês | 0x0406 | Português (Brasil) | 0x0416 |
| Holandês | 0x0413 | Romeno | 0x0418 |
| Inglês (britânico) | 0x0809 | Russo | 0x0419 |
| Inglês (EUA) | 0x0409 | Eslovaco | 0x041B |
| Finlandês | 0x040B | Esloveno | 0x0424 |
| Francês | 0x040C | Espanhol | 0x0C0A |
| Alemão | 0x0407 | Sueco | 0x041D |
| Grego | 0x0408 | Tailandês | 0x041e |
| Hebraico | 0x040D | Turco | 0x041F |
| Húngaro | 0x040E |
Se você não definir essa ID de idioma para o caractere, a ID do idioma do caractere será a ID do idioma do sistema atual.
Essa configuração também determina o idioma para a saída do TTS, o texto do balão de palavras, os comandos no menu pop-up do caractere e o mecanismo de reconhecimento de fala. Para determinar se há um mecanismo de reconhecimento de fala compatível disponível para o idioma do caractere, use IAgentCharacterEx::GetSRModeID ou IAgentCharacterEx::GetTTSModeID.
Essa propriedade se aplica somente ao uso do caractere pelo aplicativo cliente; a configuração não afeta outros clientes do caractere ou outros caracteres do aplicativo cliente.
Observação
Se a ID do idioma estiver definida como um idioma que dê suporte a texto bidirecional (como árabe ou hebraico), mas o sistema que executa seu aplicativo não tiver suporte bidirecional instalado, o texto aparecerá no balão de palavras em ordem lógica em vez de exibição.
Consulte Também
IAgentCharacterEx:SetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID