Partager via


IAgentNotifySink::Move

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures 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
);                          

Notifie à l'application cliente que le personnage a été déplacé.

  • Aucune valeur renvoyée.

dwCharID

Identifiant du personnage qui a été déplacé.

x

Coordonnée x de la nouvelle position en pixels, par rapport à l'origine de l'écran (en haut à gauche). L'emplacement d'un personnage est basé sur le coin supérieur gauche de sa trame d'animation.

y

La coordonnée y de la nouvelle position en pixels, par rapport à l'origine de l'écran (en haut à gauche). L'emplacement d'un personnage est basé sur le coin supérieur gauche de sa trame d'animation.

dwCause

La cause du déplacement du personnage. Le paramètre peut être l'un des suivants :

Valeur Description
const unsigned shortNeverMoved = 0;
Le personnage n'a pas été déplacé.
const unsigned shortUserMoved = 1;
L'utilisateur a fait glisser le personnage.
const unsigned shortProgramMoved = 2;
Votre application a déplacé le personnage.
const unsigned shortOtherProgramMoved = 3;
Une autre application a déplacé le personnage.
const unsigned shortSystemMoved = 4
Le serveur a déplacé le personnage pour le maintenir à l'écran après un changement de résolution d'écran.

Cet événement est envoyé à tous les clients du personnage.

Voir aussi

IAgentCharacter::GetMoveCause, IAgentCharacter::MoveTo