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#