IAgentCharacterEx::SetLanguageID
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
HRESULT SetLanguageID(
long langID // language ID setting of character
);
Define o conjunto de IDs de idioma para o caractere.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
Langid
-
A configuração da 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. Você pode usar os valores a seguir para os idiomas especificados. Para obter mais informações, 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 a ID do idioma para o caractere, sua ID de idioma será a ID do idioma do sistema atual se a DLL de linguagem do Agent correspondente estiver instalada; caso contrário, o idioma do caractere será inglês (EUA).
Essa propriedade também determina o idioma do texto do balão da palavra, os comandos no menu pop-up do caractere e o mecanismo de reconhecimento de fala. Ele também determina o idioma padrão para a saída TTS. Para determinar se há um mecanismo de fala compatível disponível para o idioma do caractere, use IAgentCharacterEx::GetSRModeID ou IAgentCharacterEx::GetTTSModeID.
Se você tentar definir a ID do idioma para um caractere e os recursos de linguagem agent, a página de código ou uma fonte de exibição para a ID do idioma não estiver disponível, o Agent retornará um erro e a ID do idioma do caractere permanecerá em sua última configuração. Definir essa propriedade não retornará um erro se não houver mecanismos de fala correspondentes para o idioma.
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 você definir a ID do idioma do caractere 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:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID