Mouse

Mouse 类在主框架的 CSS 像素中操作，相对于视口的左上角。

每个 page 对象都有自己的 Mouse，可通过 Page.mouse() 访问。

// 使用 ‘page.mouse’ 绘制一个 100x100 的正方形。
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#