IAgentCharacter::MoveTo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di 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
);

Riproduce l'animazione dello stato di spostamento associata e sposta la cornice di caratteri nella posizione specificata.

• Restituisce S_OK per indicare che l'operazione è riuscita. Quando la funzione restituisce, questa variabile contiene l'ID della richiesta.

X

Coordinata x della nuova posizione in pixel, rispetto all'origine dello schermo (in alto a sinistra). La posizione di un carattere si basa sull'angolo superiore sinistro della cornice di animazione.

Y

Coordinata y della nuova posizione in pixel, rispetto all'origine dello schermo (in alto a sinistra). La posizione di un carattere si basa sull'angolo superiore sinistro della cornice di animazione.

lSpeed

Parametro che specifica in millisecondi la velocità di spostamento del frame del carattere. Il valore consigliato è 1000. La specifica di zero (0) sposta la cornice senza riprodurre un'animazione.

pdwReqID

Indirizzo di una variabile che riceve l'ID richiesta MoveTo .

Quando si usa il protocollo HTTP per accedere ai dati di carattere e animazione, usare il metodo Prepare per garantire la disponibilità delle animazioni dello stato di spostamento prima di chiamare questo metodo. Anche se l'animazione non viene caricata, il server sposta ancora il frame.

Vedere anche

IAgentCharacter::SetPosition