IAgentCharacter::MoveTo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em 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 associada 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 (canto superior esquerdo). A localização de um personagem é baseada no canto superior esquerdo do quadro de animação.

y

A coordenada y da nova posição em pixels, em relação à origem da tela (canto superior esquerdo). A localização de um personagem é baseada no canto superior esquerdo do quadro de animação.

lSpeed

Um parâmetro que especifica em milissegundos a rapidez com que o quadro do personagem 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 o MoveTo ID de solicitação.

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

Ver também

IAgentCharacter::SetPosition