Evento ListenComplete

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

Descrição

Ocorre quando o modo de Compreensão Auditiva (reconhecimento de fala) terminou.

Sintaxe

Subagente.ListenComplete (ByValCharacterID, ByValCause)**

Peça	Descrição
CharacterID	Retorna a ID do caractere de escuta como uma cadeia de caracteres.
causa	Retorna a causa do evento completo 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 audição (ativado pelo código do programa) expirou. 3 O modo de audição (ativado pela tecla Listening) atingiu o tempo limite. 4 O modo de escuta foi desativado porque o usuário liberou a tecla de escuta. 5 O modo de audição 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 audição terminou porque o utilizador desativou a entrada de voz.

Comentários

Esse evento é enviado para todos os clientes quando o tempo limite do modo de escuta termina, depois que o usuário libera a tecla de escuta, quando o cliente ativo de entrada chama o método Listen com falso 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étodode escuta e, em seguida, o usuário pressionar a tecla de escuta, 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 for posterior. 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).

Ver também

evento ListenStartmétodo Listen