Compartir a través de


IAgentCharacter::MoveTo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de 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
);

Reproduce la animación de estado móvil asociada y mueve el marco de caracteres a la ubicación especificada.

  • Devuelve S_OK para indicar que la operación se realizó correctamente. Cuando la función devuelve, esta variable contiene el identificador de la solicitud.

X

Coordenada x de la nueva posición en píxeles, relativa al origen de la pantalla (superior izquierda). La ubicación de un carácter se basa en la esquina superior izquierda de su fotograma de animación.

y

Coordenada y de la nueva posición en píxeles, en relación con el origen de la pantalla (superior izquierda). La ubicación de un carácter se basa en la esquina superior izquierda de su fotograma de animación.

lSpeed

Parámetro que especifica en milisegundos la rapidez con la que se mueve el marco del carácter. El valor recomendado es 1000. Al especificar cero (0) se mueve el fotograma sin reproducir una animación.

pdwReqID

Dirección de una variable que recibe el identificador de solicitud MoveTo .

Al usar el protocolo HTTP para acceder a los datos de caracteres y animaciones, use el método Prepare para garantizar la disponibilidad de las animaciones de estado en movimiento antes de llamar a este método. Incluso si no se carga la animación, el servidor sigue mueve el marco.

Consulte también

IAgentCharacter::SetPosition