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 do idioma (LANGID) para um caractere é um valor de 16 bits definido pelo Windows, que consiste em uma ID de idioma primário e uma ID de idioma secundária. Você pode usar os seguintes valores para os idiomas especificados. Para obter mais informações, consulte a documentação do SDK da Plataforma.

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 Agente 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 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 do 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 idioma do Agente, 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.

Consulte Também

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