Partager via

IAgentCharacter::MoveTo

  • Article

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

Lit l’animation d’état de déplacement associée et déplace le cadre de caractères à l’emplacement spécifié.

  • Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction retourne, cette variable contient l’ID de la requête.

X

Coordonnée x de la nouvelle position en pixels, par rapport à l’origine de l’écran (en haut à gauche). L’emplacement d’un caractère est basé sur le coin supérieur gauche de son image d’animation.

y

Coordonnée y de la nouvelle position en pixels, par rapport à l’origine de l’écran (en haut à gauche). L’emplacement d’un caractère est basé sur le coin supérieur gauche de son image d’animation.

lSpeed

Paramètre spécifiant en millisecondes la vitesse à laquelle le frame du caractère se déplace. La valeur recommandée est 1000. La spécification de zéro (0) déplace l’image sans lire d’animation.

pdwReqID

Adresse d’une variable qui reçoit l’ID de demande MoveTo .

Lorsque vous utilisez le protocole HTTP pour accéder aux données de caractères et d’animation, utilisez la méthode Prepare pour garantir la disponibilité des animations d’état de déplacement avant d’appeler cette méthode. Même si l’animation n’est pas chargée, le serveur déplace toujours l’image.

Voir aussi

IAgentCharacter::SetPosition