Compartilhar via

IAgentCharacter::MoveTo

  • Artigo

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

HRESULT MoveTo(
   short x,         // x-coordinate of new location
   short y,         // y-coordinate of new location
   long lSpeed,     // speed to move the character
   long * pdwReqID  // address of request ID
);

Reproduz a animação de estado Movendo associado e move o quadro de caracteres para o local especificado.

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

x

A coordenada x da nova posição em pixels, em relação à origem da tela (superior esquerdo). O local de um caractere é baseado no canto superior esquerdo de seu quadro de animação.

y

A coordenada y da nova posição em pixels, em relação à origem da tela (superior esquerdo). O local de um caractere é baseado no canto superior esquerdo de seu quadro de animação.

lSpeed

Um parâmetro que especifica em milissegundos a rapidez com que o quadro do caractere se move. O valor recomendado é 1000. Especificar zero (0) move o quadro sem reproduzir uma animação.

pdwReqID

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

Ao usar o protocolo HTTP para acessar dados de caractere e animação, use o método Prepare para garantir a disponibilidade das animações de estado Movendo antes de chamar esse método. Mesmo que a animação não seja carregada, o servidor ainda move o quadro.

Consulte Também

IAgentCharacter::SetPosition