IAgentCharacter::Hide

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

HRESULT Hide(
   long bFast,      // play Hiding state animation flag
   long * pdwReqID  // address of request ID
);

Oculta o caractere.

• Retorna S_OK para indicar que a operação foi bem-sucedida. Quando a função retorna, pdwReqID contém a ID da solicitação.

bFast

Ocultar sinalizador de animação de estado. Se esse parâmetro for True, a animação Ocultar não será reproduzida antes que o quadro de caracteres esteja oculto; se False, a animação será reproduzida.

pdwReqID

Endereço de uma variável que recebe a ID de solicitação Ocultar.

O servidor enfileira a animação associada ao método Ocultar na fila do caractere. Isso permite que você o use para ocultar o caractere após uma sequência de outras animações. Você pode executar a ação imediatamente usando o método Parar antes de chamar o método Ocultar.

Ao usar o protocolo HTTP para acessar dados de caractere e animação, use o método Preparar para garantir a disponibilidade da animação de estado Ocultar antes de chamar esse método.

Ocultar um caractere também pode resultar em disparar o evento IAgentNotifySink::ActivateInputState de outro caractere visível.

Caracteres ocultos não podem acessar o canal de áudio. O servidor transmitirá um status de falha no evento RequestComplete se você gerar uma solicitação de animação e o caractere estiver oculto.

Consulte Também

IAgentCharacter::Show