aardio 文档

key 库模块帮助文档

key 成员列表

key.block()

锁定键盘鼠标

key.block(false)

解锁键盘鼠标

key.capsLk()

打开Caps Lock,切找到大写状态

key.capsLk(false)

关闭Caps Lock,切换到小写状态

key.char(字符编码)

直接用编码发送字符,例:
key.char(65)

key.combine("CTRL","字符串参数")

发送组合热键,参数个数不限.
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.delayDown

每次调用key.down函数的默认时间间隔,默认为5毫秒
在调用press以及pressEx函数时,按下松开键之间也会按此设定延时

key.delayPress

更改每次击键并松开后的时间间隔,默认为5毫秒

key.delayUp

每次调用key.up函数后的时间间隔,默认为1毫秒

key.down()

发送键按下指令,参数个数不限
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.extraInfo

发送消息的自定义附加值
该值会传入键盘钩子的extraInfo参数

key.getCode("字符串参数")

返回虚拟键码、是否扩展键

key.getName(vk,ext,noLocation)

返回虚拟键码对应的键名,
除参数@vk以外，其他参数为可选参数
如果@ext为true，允许返回扩展键名，主要指小键盘的回车键
如果参数@noLocation为true，返回键名不区分左右控制键

key.getState()

自当前线程消息队列中检测指定按键的是否按下，
仅可用于UI线程，即使线徎或进程不是前台焦点，函数仍然可以工作，
对于NumLk,CapsLk,ScrLk返回按键的开关状态

key.getStateX()

返回指定物理按键的按下弹起状态，
忽略键盘映射，可用于非UI线程，
该函数不能检测按键开关状态(nmlk,scrlk,capslk)

key.isCapsLk()

判断Caps Lock键是否打开大写状态

key.nmLk()

打开Num Lock(数字键盘功能切换)

关闭Num Lock(数字键盘功能切换)

key.press()

发送按键,参数个数不限
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.removeLocation()

对传入的虚拟键码，移除左右控制键的差别,
返回转换后的虚拟键码，例如_VK_LCTRL转换_VK_为CTRL

key.repeat(键名或键码,重复次数)

重复发送指定的击键
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.repeat(键名或键码,重复次数,间隔毫秒)

重复发送指定的击键
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.scan2v()

参数@1指定的键盘扫描码转换为虚拟码
如果参数@2为 true，则返回虚拟码区分左手键右手键

key.scrLk()

打开Scroll Lock(翻页键功能切换)

key.scrLk(false)

关闭Scroll Lock(翻页键功能切换)

key.send

发送键名串指定的按键,
发送按键而非字符串,不区分双字符键,
发送字符串请改用 key.sendString 函数

key.send("键名串",延时)

发送键名串指定的按键
每个键名都只能使用单个字符,
此函数发送按键而不是发送字符串,
键名串包含双字符键上任一字符发送的是相同按键而非对应字符,
如果打开了输入法,则由输入法确定输入的字符,
单纯发送字符串请使用 key.sendString 函数（不受输入法影响）
可选用参数@2指定每次按键之间的延时（以毫秒为单位）

key.sendString("字符串参数")

发送字符串,支持中英文字符串,
此函数不受输入法影响直接发送字符

key.sendString("字符串参数",100)

发送字符串,支持中英文字符串
并在每次按键添加指定的延时(以毫秒为单位),
此函数不受输入法影响直接发送字符

key.setState(false,键名或键码)

设置一个或多个键为松开状态
NumLk,CapsLk,ScrLk等键则置为关闭状态

key.setState(true,键名或键码)

设置一个或多个键为按下状态
NumLk,CapsLk,ScrLk等键则置为开启状态
该函数仅影响当前输入队列,外部线程应先调用 winex.attach 共享输入状态

key.up()

发送键弹起指令,参数个数不限
参数可以是键名字,或者按键的虚拟码(_VK前缀常量)

key.v2scan()

参数@1指定的键盘虚拟码转换为扫描码
如果参数@2为 true，则返回扫描码区分左手键右手键

key.wait()

等待指定按键
参数可以是键名字,或者按键的虚拟码(_VK前缀常量

key.waitUp()

等待一个按下的键放开
参数可以是键名字,或者按键的虚拟码(_VK前缀常量

全局常量

::GetAsyncKeyState()

此 API 在标准库 win 或 key 中声明,
参数@1使用数值指定虚拟键码,返回值为 16位数值,
应当使用返回值与 0x8000 做位与运算取最高位,
最高位表示指定按键是否按下
用法请参考 key.getStateX 函数源码

::GetKeyState()

此 API 在标准库 win 或 key 中声明,
参数@1使用数值指定虚拟键码,返回值为 16位数值,
最高位表示指定按键是否按下,最低位表示 NumLk,CapsLk,ScrLk 是否按下
用法请参考 key.getState 函数源码

Markdown 格式