鼠标

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 [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 X 坐标。

• y [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 Y 坐标。

• options MouseClickOptions? (可选)

  • Button 枚举 MouseButton { Left, Right, Middle }? (可选)#

    默认为 left。

  • ClickCount int? (可选)#

    默认为 1。请参阅 UIEvent.detail。

  • Delay [浮点数]? (可选)#

    在 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 [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 X 坐标。

• y [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 Y 坐标。

• options MouseDblClickOptions? (可选)

  • Button 枚举 MouseButton { Left, Right, Middle }? (可选)#

    默认为 left。

  • Delay [浮点数]? (可选)#

    在 mousedown 和 mouseup 之间等待的时间（以毫秒为单位）。默认为 0。

返回值

• void#

---

DownAsync

在 v1.9 之前添加 mouse.DownAsync

分派 mousedown 事件。

用法

await Mouse.DownAsync(options);

参数

• options MouseDownOptions? (可选)

  • Button 枚举 MouseButton { Left, Right, Middle }? (可选)#

    默认为 left。

  • ClickCount int? (可选)#

    默认为 1。请参阅 UIEvent.detail。

返回值

• void#

---

MoveAsync

在 v1.9 之前添加 mouse.MoveAsync

分派 mousemove 事件。

用法

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

参数

• x [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 X 坐标。

• y [浮点数]#

  相对于主框架视口以 CSS 像素为单位的 Y 坐标。

• options MouseMoveOptions? (可选)

  • Steps int? (可选)#

    默认为 1。发送中间 mousemove 事件。

返回值

• void#

---

UpAsync

在 v1.9 之前添加 mouse.UpAsync

分派 mouseup 事件。

用法

await Mouse.UpAsync(options);

参数

• options MouseUpOptions? (可选)

  • Button 枚举 MouseButton { Left, Right, Middle }? (可选)#

    默认为 left。

  • ClickCount int? (可选)#

    默认为 1。请参阅 UIEvent.detail。

返回值

• void#

---

WheelAsync

在以下版本中添加：v1.15 mouse.WheelAsync

分派 wheel 事件。此方法通常用于手动滚动页面。有关滚动页面的其他方法，请参阅 滚动。

注意

如果未处理滚轮事件，则可能会导致滚动，并且此方法在返回之前不会等待滚动完成。

用法

await Mouse.WheelAsync(deltaX, deltaY);

参数

• deltaX [浮点数]#

  水平滚动的像素数。

• deltaY [浮点数]#

  垂直滚动的像素数。

返回值

• void#