Compartilhar via


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

Ocultando o sinalizador de animação de estado. Se esse parâmetro for True, a animação Hiding 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 Hide 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 Stop antes de chamar o método Hide .

Ao usar o protocolo HTTP para acessar dados de caracteres e animação, use o método Prepare para garantir a disponibilidade da animação De ocultar estado antes de chamar esse método.

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

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

Consulte Também

IAgentCharacter::Show