共用方式為


IAgentCharacter::MoveTo

[Microsoft代理程式從 Windows 7 開始已被取代,而且可能無法在後續版本的 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
);

播放相關聯的 移動 狀態動畫,並將字元框架移至指定的位置。

  • 傳回S_OK,表示作業成功。 當函式傳回時,此變數會包含要求的標識碼。

x

相對於螢幕原點(左上方),以像素為單位的新位置 X 座標。 字元的位置是根據其動畫畫面的左上角。

y

新位置的 Y 座標,以像素為單位,相對於螢幕原點(左上方)。 字元的位置是根據其動畫畫面的左上角。

lSpeed

參數,以毫秒為單位指定字元框架移動的速度。 建議值為 1000。 指定零 (0) 會移動框架,而不播放動畫。

pdwReqID

接收moveTo要求標識碼變數的位址。

使用 HTTP 通訊協定存取字元和動畫數據時,請使用 Prepare 方法來確保呼叫此方法之前,移動 狀態動畫的可用性。 即使未載入動畫,伺服器仍會移動畫面。

另請參閱

IAgentCharacter::SetPosition