Mouse

Mouse 類別以主框架 CSS 像素運作，相對於視窗左上角。

每個 page 物件都有自己的滑鼠 (Mouse)，可透過 Page.Mouse 存取。

await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.DownAsync();
await Page.Mouse.MoveAsync(0, 100);
await Page.Mouse.MoveAsync(100, 100);
await Page.Mouse.MoveAsync(100, 0);
await Page.Mouse.MoveAsync(0, 0);
await Page.Mouse.UpAsync();

---

方法

ClickAsync

在 v1.9 之前新增 mouse.ClickAsync

是 Mouse.MoveAsync()、Mouse.DownAsync()、Mouse.UpAsync() 的快捷方式。

用法

await Mouse.ClickAsync(x, y, options);

參數

• x [float]#

  X 坐標，相對於主框架視窗的 CSS 像素。

• y [float]#

  Y 坐標，相對於主框架視窗的 CSS 像素。

• options MouseClickOptions? (選用)

  • Button enum MouseButton { Left, Right, Middle }? (選用)#

    預設為 left。

  • ClickCount int? (選用)#

    預設為 1。請參閱 UIEvent.detail。

  • Delay [float]? (選用)#

    mousedown 和 mouseup 之間等待的時間，以毫秒為單位。預設為 0。

返回

• void#

---

DblClickAsync

在 v1.9 之前新增 mouse.DblClickAsync

是 Mouse.MoveAsync()、Mouse.DownAsync()、Mouse.UpAsync()、Mouse.DownAsync() 和 Mouse.UpAsync() 的快捷方式。

用法

await Mouse.DblClickAsync(x, y, options);

參數

• x [float]#

  X 坐標，相對於主框架視窗的 CSS 像素。

• y [float]#

  Y 坐標，相對於主框架視窗的 CSS 像素。

• options MouseDblClickOptions? (選用)

  • Button enum MouseButton { Left, Right, Middle }? (選用)#

    預設為 left。

  • Delay [float]? (選用)#

    mousedown 和 mouseup 之間等待的時間，以毫秒為單位。預設為 0。

返回

• void#

---

DownAsync

在 v1.9 之前新增 mouse.DownAsync

發送 mousedown 事件。

用法

await Mouse.DownAsync(options);

參數

• options MouseDownOptions? (選用)

  • Button enum MouseButton { Left, Right, Middle }? (選用)#

    預設為 left。

  • ClickCount int? (選用)#

    預設為 1。請參閱 UIEvent.detail。

返回

• void#

---

MoveAsync

在 v1.9 之前新增 mouse.MoveAsync

發送 mousemove 事件。

用法

await Mouse.MoveAsync(x, y, options);

參數

• x [float]#

  X 坐標，相對於主框架視窗的 CSS 像素。

• y [float]#

  Y 坐標，相對於主框架視窗的 CSS 像素。

• options MouseMoveOptions? (選用)

  • Steps int? (選用)#

    預設為 1。發送中繼 mousemove 事件。

返回

• void#

---

UpAsync

在 v1.9 之前新增 mouse.UpAsync

發送 mouseup 事件。

用法

await Mouse.UpAsync(options);

參數

• options MouseUpOptions? (選用)

  • Button enum MouseButton { Left, Right, Middle }? (選用)#

    預設為 left。

  • ClickCount int? (選用)#

    預設為 1。請參閱 UIEvent.detail。

返回

• void#

---

WheelAsync

新增於：v1.15 mouse.WheelAsync

發送 wheel 事件。此方法通常用於手動滾動頁面。請參閱 scrolling 以了解滾動的替代方法。

注意

如果未處理滾輪事件，可能會導致滾動，並且此方法不會等待滾動完成才返回。

用法

await Mouse.WheelAsync(deltaX, deltaY);

參數

• deltaX [float]#

  水平滾動的像素。

• deltaY [float]#

  垂直滾動的像素。

返回

• void#