IAgentCharacterEx::SetLanguageID

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

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

Define a ID de idioma definida para o caractere.

• Retorna S_OK para indicar que a operação foi bem-sucedida.

langID

A configuração de ID de idioma para o caractere.

Um inteiro longo especificando a ID do idioma para o caractere. O ID de idioma (LANGID) de um caractere é um valor de 16 bits definido pelo Windows, consistindo em um ID de idioma primário e um ID de idioma secundário. Você pode usar os seguintes valores para os idiomas especificados. Para obter mais informações, consulte a documentação do Platform SDK.

Se você não definir a ID de idioma para o caractere, sua ID de idioma será a ID de idioma do sistema atual se a DLL de idioma do agente correspondente estiver instalada; caso contrário, o idioma do personagem será inglês (EUA).

Essa propriedade também determina o idioma do texto do balão de palavras, 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 de idioma para um caractere e os recursos de idioma do Agente, a página de código ou uma fonte de exibição para a ID de idioma não estiverem disponíveis, o Agente retornará um erro e a ID de idioma do caractere permanecerá em sua última configuração. A configuração dessa propriedade não retornará um erro se não houver mecanismos de fala correspondentes para o idioma.

Esta propriedade aplica-se apenas ao uso do caractere pelo seu aplicativo cliente; A configuração não afeta outros clientes do caractere ou outros caracteres do seu aplicativo cliente.

Ver também

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