IAgentCharacter::Ocultar

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

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

Esconde o personagem.

• 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 sinalizador de animação de estado. Se esse parâmetro for True, a animação Ocultando não será reproduzida antes que o quadro do caractere esteja oculto; se Falso, a animação é reproduzida.

pdwReqID

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

O servidor enfileira a animação associada ao método Ocultar na fila do personagem. Isso permite que você o use para ocultar o personagem após uma sequência de outras animações. Você pode reproduzir 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ções, use o método Prepare para garantir a disponibilidade da animação de estado Ocultando antes de chamar esse método.

Ocultar um caractere também pode resultar no acionamento do IAgentNotifySink::ActivateInputState evento de outro caractere visível.

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

Ver também

IAgentCharacter::Mostrar