Compartir a través de


IAgentNotifySink::Move

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

HRESULT Move(
   long dwCharID,  // character ID
   long x,         // x-coordinate of new location
   long y,         // y-coordinate of new location
   long dwCause    // cause of move state
);                          

Notifica a una aplicación cliente cuando se ha movido el carácter.

  • No de devuelve ningún valor.

dwCharID

Identificador del carácter que se ha movido.

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, 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.

dwCause

Causa del movimiento del carácter. El parámetro puede ser uno de los siguientes:

Value Descripción
const unsigned shortNeverMoved = 0;
El carácter no se ha movido.
const unsigned shortUserMoved = 1;
El usuario arrastró el carácter.
const unsigned shortProgramMoved = 2;
La aplicación movió el carácter.
const unsigned shortOtherProgramMoved = 3;
Otra aplicación movió el carácter.
const unsigned shortSystemMoved = 4
El servidor movió el carácter para mantenerlo en pantalla después de un cambio de resolución de pantalla.

Este evento se envía a todos los clientes del carácter.

Consulte también

IAgentCharacter::GetMoveCause, IAgentCharacter::MoveTo