跳至主要内容

鼠标

Mouse类在主框架的CSS像素中运行,相对于视口的左上角。

每个page对象都有自己的鼠标控制器,可通过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

Added before 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]? (可选)#

      mousedownmouseup之间等待的时间,单位为毫秒。默认为0。

返回


DblClickAsync

Added before 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]? (可选)#

      mousedownmouseup之间等待的时间,单位为毫秒。默认为0。

返回


DownAsync

Added before v1.9 mouse.DownAsync

派发一个mousedown事件。

用法

await Mouse.DownAsync(options);

参数

  • options MouseDownOptions? (optional)
    • Button enum MouseButton { Left, Right, Middle }? (可选)#

      默认为 left

    • ClickCount int? (可选)#

      默认为1。参见UIEvent.detail

返回


MoveAsync

Added before 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事件。

返回


异步上传

Added before v1.9 mouse.UpAsync

触发一个 mouseup 事件。

用法

await Mouse.UpAsync(options);

参数

  • options MouseUpOptions? (optional)
    • Button enum MouseButton { Left, Right, Middle }? (可选)#

      默认为 left

    • ClickCount int? (可选)#

      默认为1。参见UIEvent.detail

返回


WheelAsync

Added in: v1.15 mouse.WheelAsync

派发一个wheel事件。此方法通常用于手动滚动页面。关于其他滚动方式,请参阅scrolling

note

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

用法

await Mouse.WheelAsync(deltaX, deltaY);

参数

  • deltaX [float]#

    水平滚动像素数。

  • deltaY [float]#

    垂直滚动的像素数。

返回