MoveTo Method
[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]
- Description
-
Moves the specified character to the specified location.
- Syntax
-
agent.Characters ("CharacterID").MoveTo x,y[Speed]
Part Description x,y Required. An integer value that indicates the left edge (x) and top edge (y) of the animation frame. Express these coordinates in pixels. Speed Optional. A Long integer value specifying in milliseconds how quickly the character's frame moves. The default value is 1000. Specifying zero (0) moves the frame without playing an animation.
Remarks
The server automatically plays the appropriate animation assigned to the Moving states. The location of a character is based on the upper left corner of its frame.
If you declare an object variable and set it to this method, it returns a Request object. In addition, if the associated animation has not been loaded on the local machine, the server sets the Request object's Status property to "failed" with an appropriate error number. Therefore, if you are using the HTTP protocol to access character or animation data, use the Get method to load the Moving state animations before calling the MoveTo method.
Even if the animation is not loaded, the server still moves the frame.