YStudio Y++

键盘支持库

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

路径:支持库 → 键盘支持库 → 键盘操作。

硬约束

  1. 扁平命令;键码为虚拟键码整数(#A键、#回车键、#F1键 等系统常量)。
  2. 修饰键标志可相加:Alt=1 · Ctrl=2 · Shift=4 · Win=8(如 Ctrl+Shift=6)。
  3. 模拟经 SendInput;高权限/游戏窗可能拦截。
  4. 与控件「按键按下」事件不同:本库是全局操作命令。
  5. 键盘输入文本* 前目标窗口须已获焦点。
  6. 默认输入延迟 10 ms(置按键输入延迟)。适用 Windows 10 / 11。

快速开始

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

键盘操作

本分类共 19 条。

按键是否按下

  • 签名:逻辑 按键是否按下(整数 键码)
  • 说明:判断指定虚拟键当前是否处于按下状态。
  • 参数一│键码: 虚拟键码,可用 #A键 等系统常量

模拟按键

  • 签名:逻辑 模拟按键(整数 键码)
  • 说明:模拟按下并放开指定键(单击一次)。成功返回真。
  • 参数一│键码: 虚拟键码

模拟按键次数

  • 签名:逻辑 模拟按键次数(整数 键码, 整数 次数, 整数 间隔毫秒)
  • 说明:连续模拟按键若干次;间隔为两次之间的等待。
  • 参数一│键码
  • 参数二│次数
  • 参数三│间隔毫秒: 两次之间的间隔,可为 0

模拟按键按下

  • 签名:逻辑 模拟按键按下(整数 键码)
  • 说明:模拟按下指定键(不放开)。
  • 参数一│键码

模拟按键放开

  • 签名:逻辑 模拟按键放开(整数 键码)
  • 说明:模拟放开指定键。
  • 参数一│键码

模拟组合键

  • 签名:逻辑 模拟组合键(整数 修饰键, 整数 键码)
  • 说明:模拟修饰键+主键组合(如 Ctrl+C)。成功返回真。
  • 参数一│修饰键: Alt=1 Ctrl=2 Shift=4 Win=8,可相加
  • 参数二│键码: 主键虚拟键码

键盘输入文本

  • 签名:逻辑 键盘输入文本(文本 内容)
  • 说明:向当前焦点窗口逐字输入 Unicode 文本(含中文)。字间延迟用「置按键输入延迟」(默认 10ms)。在本程序事件回调里调用时会泵送消息,便于本窗文本框立刻收到字符。成功返回真。
  • 参数一│内容: 要输入的文本

键盘输入文本Ex

  • 签名:逻辑 键盘输入文本Ex(文本 内容, [整数 字间毫秒=-1])
  • 说明:逐字输入。第二参可省略:-1/省略=用全局默认延迟;0=尽快(仍泵一次消息)。
  • 参数一│内容
  • 参数二│[字间毫秒=-1]

等待按键

  • 签名:逻辑 等待按键(整数 键码, 整数 超时毫秒)
  • 说明:阻塞等待指定键按下。超时毫秒小于 0 表示一直等。按下返回真,超时返回假。
  • 参数一│键码
  • 参数二│超时毫秒: 负数表示无限等待

等待任意按键

  • 签名:整数 等待任意按键(整数 超时毫秒)
  • 说明:阻塞等待任意键盘键按下(不含鼠标键)。返回键码,超时返回 0。
  • 参数一│超时毫秒: 负数表示无限等待

释放全部修饰键

  • 签名:逻辑 释放全部修饰键()
  • 说明:强制放开 Shift/Ctrl/Alt/Win(含左右),避免组合键卡住。

置按键输入延迟

  • 签名:无 置按键输入延迟(整数 毫秒)
  • 说明:设置 模拟按键 / 键盘输入文本 等默认间隔(毫秒)。默认 10。
  • 参数一│毫秒

取按键输入延迟

  • 签名:整数 取按键输入延迟()
  • 说明:取得当前默认按键输入间隔(毫秒)。

CapsLock是否打开

  • 签名:逻辑 CapsLock是否打开()
  • 说明:判断 Caps Lock 指示灯是否打开。

NumLock是否打开

  • 签名:逻辑 NumLock是否打开()
  • 说明:判断 Num Lock 指示灯是否打开。

ScrollLock是否打开

  • 签名:逻辑 ScrollLock是否打开()
  • 说明:判断 Scroll Lock 指示灯是否打开。

切换CapsLock

  • 签名:逻辑 切换CapsLock()
  • 说明:切换 Caps Lock 开关状态。

切换NumLock

  • 签名:逻辑 切换NumLock()
  • 说明:切换 Num Lock 开关状态。

切换ScrollLock

  • 签名:逻辑 切换ScrollLock()
  • 说明:切换 Scroll Lock 开关状态。

易错对照

错误 正确
修饰键当名字直接传 用整数标志相加
输入文本前未聚焦 先激活目标窗口
与控件按键事件混淆 本库是全局注入命令

相关

热键支持库 · 鼠标支持库 · 回调