Mouse

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

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

// Using ‘page.mouse’ to trace a 100x100 square.
page.mouse().move(0, 0);
page.mouse().down();
page.mouse().move(0, 100);
page.mouse().move(100, 100);
page.mouse().move(100, 0);
page.mouse().move(0, 0);
page.mouse().up();

---

方法

click

在 v1.9 之前新增 mouse.click

Mouse.move()、Mouse.down()、Mouse.up() 的快速方式。

用法

Mouse.click(x, y);
Mouse.click(x, y, options);

參數

• x double#

  相對於主框架視窗的 X 座標，以 CSS 像素為單位。

• y double#

  相對於主框架視窗的 Y 座標，以 CSS 像素為單位。

• options Mouse.ClickOptions (選填)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (選填)#

    預設為 left。

  • setClickCount int (選填)#

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

  • setDelay double (選填)#

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

返回值

• void#

---

dblclick

在 v1.9 之前新增 mouse.dblclick

Mouse.move()、Mouse.down()、Mouse.up()、Mouse.down() 和 Mouse.up() 的快速方式。

用法

Mouse.dblclick(x, y);
Mouse.dblclick(x, y, options);

參數

• x double#

  相對於主框架視窗的 X 座標，以 CSS 像素為單位。

• y double#

  相對於主框架視窗的 Y 座標，以 CSS 像素為單位。

• options Mouse.DblclickOptions (選填)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (選填)#

    預設為 left。

  • setDelay double (選填)#

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

返回值

• void#

---

down

在 v1.9 之前新增 mouse.down

觸發 mousedown 事件。

用法

Mouse.down();
Mouse.down(options);

參數

• options Mouse.DownOptions (選填)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (選填)#

    預設為 left。

  • setClickCount int (選填)#

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

返回值

• void#

---

move

在 v1.9 之前新增 mouse.move

觸發 mousemove 事件。

用法

Mouse.move(x, y);
Mouse.move(x, y, options);

參數

• x double#

  相對於主框架視窗的 X 座標，以 CSS 像素為單位。

• y double#

  相對於主框架視窗的 Y 座標，以 CSS 像素為單位。

• options Mouse.MoveOptions (選填)

  • setSteps int (選填)#

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

返回值

• void#

---

up

在 v1.9 之前新增 mouse.up

觸發 mouseup 事件。

用法

Mouse.up();
Mouse.up(options);

參數

• options Mouse.UpOptions (選填)

  • setButton enum MouseButton { LEFT, RIGHT, MIDDLE } (選填)#

    預設為 left。

  • setClickCount int (選填)#

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

返回值

• void#

---

wheel

新增於：v1.15 mouse.wheel

觸發 wheel 事件。此方法通常用於手動捲動頁面。請參閱 捲動 以了解其他捲動方式。

注意

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

用法

Mouse.wheel(deltaX, deltaY);

參數

• deltaX double#

  水平滾動的像素。

• deltaY double#

  垂直滾動的像素。

返回值

• void#