Compartilhar via


Evento ListenComplete

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

Descrição

Ocorre quando o modo de escuta (reconhecimento de fala) termina.

Sintaxe

Sub agent.ListenComplete (ByValCharacterID, ByValCause)**

Parte Descrição
CharacterID Retorna o ID do caractere de escuta como uma cadeia de caracteres.
Causa Retorna a causa do evento complete como um inteiro que pode ser um dos seguintes: 1 O modo de escuta foi desativado pelo código do programa.
2 O modo de escuta (ativado pelo código do programa) atingiu o tempo limite.
3 O modo de escuta (ativado pela tecla Listening) atingiu o tempo limite.
4 O modo de escuta foi desativado porque o usuário soltou a tecla Listening.
5 O modo de escuta terminou porque o usuário terminou de falar.
6 O modo de escuta terminou porque o cliente ativo de entrada foi desativado.
7 O modo de escuta terminou porque o caractere padrão foi alterado.
8 O modo de escuta terminou porque o usuário desativou a entrada de fala.

Comentários

Esse evento é enviado a todos os clientes quando o tempo limite do modo de escuta termina, depois que o usuário solta a tecla Listening, quando o cliente ativo de entrada chama o método Listen com False ou o usuário termina de falar. Você pode usar esse evento para determinar quando retomar a saída de caracteres falados (áudio).

Se você ativar o modo de escuta usando o método Listen e, em seguida, o usuário pressionar a tecla Listening, o modo de escuta será redefinido e continuará até que o tempo limite da tecla de escuta seja concluído, a tecla de escuta seja liberada ou o usuário termine de falar, o que ocorrer mais tarde. Nessa situação, você não receberá um evento ListenComplete até que o modo da tecla de escuta seja concluído.

O evento retorna o caractere para os clientes que atualmente têm esse caractere carregado. Todos os outros clientes recebem um caractere nulo (cadeia de caracteres vazia).

Confira também

Evento ListenStart, método Listen