Compartilhar via


Método MoveTo

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

Descrição

Move o caractere especificado para o local especificado.

Sintaxe

agent**. Caracteres ("CharacterID"). MoveTo** x,y[Speed]

Parte Descrição
x,y Obrigatórios. 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 que especifica 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 de Movimentação . O local de um caractere é baseado no canto superior esquerdo de seu quadro.

Se você declarar uma variável de objeto e defini-la para esse método, ela retornará um objeto Request . Além disso, se a animação associada não tiver sido carregada no computador local, o servidor definirá a propriedade Status do objeto Request como "com falha" 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 em movimento 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á uma falha status se você atribuiu a ele um objeto Request, pois o valor diferente de zero indica que você está tentando reproduzir uma animação quando o caractere não estiver 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.