动作
ascript.windows import action
模拟 鼠标 和 键盘 操作
常量
鼠标键值
鼠标左键
LEFT = "left"
鼠标中键
MIDDLE = "middle"
鼠标右键
RIGHT = "right"
鼠标默认按键
PRIMARY = "primary"
鼠标辅助按键
SECONDARY = "secondary"
方法
点击
模拟鼠标操作
函数原型
action.click(x=None, y=None, clicks=1, interval=0.0, button=PRIMARY, duration=0.02, tween=pyautogui.linear)
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| x | int | 是 | 要点击的屏幕X坐标 |
| y | int | 是 | 要点击的屏幕Y坐标 |
| clicks | int | 否 | 点击次数 |
| interval | float | 否 | 点击间隔 |
| button | string | 否 | 鼠标按键值: primary:默认左键 left:左键 right:右键 middle:中键 |
| duration | float | 否 | 点击持续时间 |
| tween | fun | 否 | 插值函数,移动速率 |
滚动
模拟鼠标滚轮
函数原型
action.scroll(lines: int, x: int = None, y: int = None, h: bool = False, v: bool = True)
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| lines | int | 是 | 滚动的距离 |
| x | int | 否 | 滚动之前，鼠标移动的坐标x |
| y | int | 否 | 滚动之前，鼠标移动的坐标y |
| h | bool | 否 | 是否横向滚动 |
| v | bool | 否 | 是否纵向滚动 |
拖拽
模拟 鼠标拖拽
函数原型
action.drag(start_x: int, start_y: int, to_x: int, to_y: int, duration: float = 0.5)
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| start_x | int | 是 | 拖拽起始点X坐标 |
| start_y | int | 是 | 拖拽起始点y坐标 |
| to_x | int | 是 | 拖拽结束点x坐标 |
| to_y | int | 是 | 拖拽结束点y坐标 |
| duration | int | 否 | 拖拽时间长度 默认0.5秒 |
鼠标按下
模拟鼠标 按下
函数原型
action.mouse_down(x: int, y: int, button: str = PRIMARY, duration: float = 0.5, tween=pyautogui.linear)
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| x | int | 是 | 鼠标按下的坐标X |
| y | int | 是 | 鼠标按下的坐标y |
| button | str | 否 | 鼠标按键值: primary:默认左键 left:左键 right:右键 middle:中键 |
| duration | float | 否 | 按下持续时间长度 默认0.5秒 |
| tween | int | 否 | 插值函数,移动速率 |
鼠标移动
模拟鼠标 移动
函数原型
action.mouse_move(x: int, y: int, duration: float = 0.5, tween=pyautogui.linear)
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| x | int | 是 | 鼠标按下的坐标X |
| y | int | 是 | 鼠标按下的坐标y |
| duration | float | 否 | 按下持续时间长度 默认0.5秒 |
| tween | int | 否 | 插值函数,移动速率 |
鼠标抬起
模拟鼠标 抬起
函数原型
actionmouse_up(x: int, y: int, button: str = PRIMARY, duration: float = 0.5, tween=pyautogui.linear):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| x | int | 是 | 鼠标按下的坐标X |
| y | int | 是 | 鼠标按下的坐标y |
| button | str | 否 | 鼠标按键值: primary:默认左键 left:左键 right:右键 middle:中键 |
| duration | float | 否 | 按下持续时间长度 默认0.5秒 |
| tween | int | 否 | 插值函数,移动速率 |
输入
快速输入文本
函数原型
actioninput(msg: str, interval=0.0):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| msg | str | 是 | 要输入的内容 |
| interval | float | 否 | 每个字符输入的时间间隔 默认:0 |
模拟按键
模拟连续按下键盘按键
函数原型
actionkey(keys, presses=1, interval=0.0):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| keys | str | str[] | 是 |
| presses | int | 否 | 按下的次数 默认:1 |
| interval | float | 否 | 每个按键按下的时间间隔 默认:0 |
模拟快捷按键
模块 “同时按下” 快捷按键组合
函数原型
actionkey_hot(*args, **kwargs):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| keys | str...可变参数 | 是 | 要按下的组合按键: 'alt','tab':这模拟了快速切换窗口 |
按键按下
模拟某一按键 按下
函数原型
actionkey_down(key: str):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| key | str | 是 | 要按下的按键: 'a':模拟按下按键a |
按键抬起
模拟某一按键 抬起
函数原型
actionkey_up(key:str):
参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| key | str | 是 | 要抬起的按键: 'a':模拟抬起按键a |
示例
鼠标 ‘左键’ 单击 某个坐标
from ascript.action
action.click(42, 45)
- 鼠标 ‘左键’ 双击 某个坐标
from ascript.windows.action import click
click(42, 45,clicks=2)
鼠标 ‘左键’ 双击 某个坐标 ,每次点击间隔 0.2秒
from ascript.windows.action import click
click(42, 45,clicks=2,interval=0.2)
鼠标 ‘左键’ 单击 某个 坐标 持续时间 2秒
from ascript.windows.action import click
click(42, 45,duration=2)
鼠标 ‘右键’ 单击 某个 坐标
from ascript.windows.action import click
click(42, 45,button='right')
鼠标 ‘中键’ 单击 某个 坐标
from ascript.windows.action import click
click(42, 45,button='middle')
在 鼠标停留 的位置，纵向滚动
from ascript.windows.action import scroll
scroll(200)
在 鼠标停留 的位置，横向滚动
from ascript.windows.action import scroll
scroll(200,h=True)
在 屏幕坐标x:100,y:100 的位置，纵向滚动
from ascript.windows.action import scroll
scroll(200,100,100)
按住鼠标左键拖拽
from ascript.windows.action import drag
drag(47,33,154,34)
按住鼠标左键拖拽，耗时 2秒
from ascript.windows.action import drag
drag(47,33,154,34,2)
模拟鼠标点住不放
from ascript.windows.action import mouse_down
mouse_down(47,25)
模拟鼠标移动 到 指定坐标点
from ascript.windows.action import mouse_move
mouse_move(47,25)
模拟鼠标移动 到 指定坐标点 ，并指定移动时间为2秒
from ascript.windows.action import mouse_move
mouse_move(47,25,duration=2)
模拟鼠标 拖拽 停留 释放 操作
import time
from ascript.windows.action import mouse_down,mouse_move,mouse_up
mouse_down(47,25) # 在这个坐标按下
mouse_move(200,25,1) #1秒内移动鼠标到 200,25
time.sleep(1) # 继续按住鼠标坚持1秒
mouse_up(200,25) # 在（200,25）坐标松开鼠标
输入 “你好” 两个字
from ascript.windows.action import input
input("你好")
模拟按下按键
from ascript.windows.action import key
key("f")
连续多次按下 指定按键
from ascript.windows.action import key
key('a',presses=2)
模拟连续按下两个按键，并设置每次按下的时间 间隔
from ascript.windows.action import key
key(['a','f'],interval=0.5)
模拟 组合快捷键
from ascript.windows.action import key
key_hot('alt','tab')
模拟 按键按下不松开
from ascript.windows.action import key_down
key_down('a')
模拟 按下按键2秒后抬起
import time
from ascript.windows.action import key_down,key_up
key_down('a')
time.sleep(2)
key_up('a')