键盘支持库

Y++ / YStudio 开发文档 · 一点滴

扁平命令式支持库（不是类）。路径：支持库 → 键盘支持库 → 键盘操作。

适用：Windows 10 / 11（x86、x64）。

键码：虚拟键码整数，与系统常量一致（如 #A键、#回车键、#F1键、#空格键、#Ctrl键）。
修饰键标志（与热键相同，可相加）：Alt=1，Ctrl=2，Shift=4，Win=8。例如 Ctrl+Shift=6。
模拟方式：SendInput 注入；部分高权限或游戏窗口可能拦截。
与事件区别：本库是全局操作命令；窗体/控件的「按键按下」等是事件回调。

输入文本前请确保目标窗口已获得键盘焦点。

快速开始

启动() {
    置按键输入延迟(20)
    模拟组合键(2, #C键)        // Ctrl+C
    键盘输入文本("Hello 你好")
    释放全部修饰键()           // 防修饰键卡住
}

连按 / 等待：

模拟按键次数(#下键, 5, 50)

如果 (等待按键(#空格键, 5000)) {
    输出("空格已按")
}

整数 k = 等待任意按键(10000)
如果 (k > 0) {
    输出("按下键码: " + 到文本(k))
}

单独按下再放开（等价组合的一种写法）：

模拟按键按下(#Shift键)
模拟按键(#A键)          // 相当于 Shift+A
模拟按键放开(#Shift键)

命令一览

命令	返回	说明
`按键是否按下(键码)`	逻辑	当前是否按下
`模拟按键(键码)`	逻辑	单击一次（按下并放开）
`模拟按键次数(键码, 次数, 间隔毫秒)`	逻辑	连按；间隔可为 0
`模拟按键按下(键码)`	逻辑	只按下不放开
`模拟按键放开(键码)`	逻辑	只放开
`模拟组合键(修饰键, 键码)`	逻辑	如 Ctrl+C：`模拟组合键(2, #C键)`
`键盘输入文本(内容)`	逻辑	Unicode 逐字输入（含中文）；字间延迟见下
`键盘输入文本Ex(内容, 字间毫秒)`	逻辑	指定每个字符间隔
`等待按键(键码, 超时毫秒)`	逻辑	等到按下返回真，超时假；超时小于 0 一直等；等待时泵消息
`等待任意按键(超时毫秒)`	整数	返回键码，超时返回 0；不含鼠标键
`释放全部修饰键()`	逻辑	强制放开 Shift/Ctrl/Alt/Win（含左右）
`置按键输入延迟(毫秒)`	无	默认间隔，默认 10；影响模拟按键与 `键盘输入文本`
`取按键输入延迟()`	整数	当前默认间隔
`CapsLock是否打开()`	逻辑	Caps Lock 指示灯
`NumLock是否打开()`	逻辑	Num Lock
`ScrollLock是否打开()`	逻辑	Scroll Lock
`切换CapsLock()`	逻辑	切换 Caps
`切换NumLock()`	逻辑	切换 Num
`切换ScrollLock()`	逻辑	切换 Scroll

常用组合示例

模拟组合键(2, #A键)    // Ctrl+A
模拟组合键(2, #C键)    // Ctrl+C
模拟组合键(2, #V键)    // Ctrl+V
模拟组合键(2, #Z键)    // Ctrl+Z
模拟组合键(6, #S键)    // Ctrl+Shift+S
模拟组合键(1, #F4键)   // Alt+F4
模拟组合键(8, #E键)    // Win+E

慢速中文输入：

置按键输入延迟(40)
键盘输入文本("欢迎使用 Y++")
// 或：
键盘输入文本Ex("逐字变慢", 80)

锁定键：

如果 (CapsLock是否打开() == 假) {
    切换CapsLock()
}

常用键码参考

除系统常量（#回车键 等）外，也可用整数。常见值：

键	常量示例	常见数值
A～Z	`#A键` …	65～90
回车	`#回车键`	13
Esc	`#Esc键`	27
空格	`#空格键`	32
Tab	`#Tab键`	9
Backspace	`#退格键`	8
左/上/右/下	`#左键` 等	37～40
F1～F12	`#F1键` …	112～123
Ctrl / Shift / Alt	`#Ctrl键` 等	17 / 16 / 18

具体以 IDE 系统常量与本机为准；不确定时用 等待任意按键 打印返回的键码。