IAgentCharacter ::MoveTo

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible 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 vers l’emplacement spécifié.

• Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction est retournée, 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 cadre 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 cadre d’animation.

lSpeed

Paramètre spécifiant en millisecondes la rapidité de déplacement du cadre du caractère. La valeur recommandée est 1 000. La spécification de zéro (0) déplace l’image sans lire une animation.

pdwReqID

Adresse d’une variable qui reçoit l’ID de requête MoveTo.

Lorsque vous utilisez le protocole HTTP pour accéder aux données de caractère et d’animation, utilisez la méthode Prepare pour garantir la disponibilité des animations d’état déplacer 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