Método MoveTo

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

Descrição

Move o caractere especificado para o local especificado.

Sintaxe

agente**. Personagens ("CharacterID"). MoveTo** x,y[Velocidade]

Peça	Descrição
x,y	Necessário. Um valor inteiro que indica a borda esquerda (x) e a borda superior (y) do quadro de animação. Expresse essas coordenadas em pixels.
Velocidade	Opcional. Um valor inteiro longo especificando em milissegundos a rapidez com que o quadro do caractere se move. O valor padrão é 1000. Especificar zero (0) move o quadro sem reproduzir uma animação.

 

Comentários

O servidor reproduz automaticamente a animação apropriada atribuída aos estados Moving. A localização de um caractere é baseada no canto superior esquerdo de seu quadro.

Se você declarar uma variável de objeto e defini-la para esse método, ela retornará uma Request objeto. Além disso, se a animação associada não tiver sido carregada na máquina local, o servidor definirá a propriedade Status do objeto Request como "failed" com um número de erro apropriado. Portanto, se você estiver usando o protocolo HTTP para acessar dados de caractere ou animação, use o método Get para carregar as animações de estado Moving antes de chamar o método MoveTo.

Mesmo que a animação não seja carregada, o servidor ainda move o quadro.

Observação

Se você chamar MoveTo com um valor diferente de zero antes que o caractere seja mostrado, ele retornará um status de falha se você tiver atribuído a ele um objeto Request, porque o valor diferente de zero indica que você está tentando reproduzir uma animação quando o caractere não está visível.

 

Observação

O efeito real do parâmetro Speed pode variar com base na velocidade do processador do computador e na prioridade de outras tarefas em execução no sistema.