YStudio Y++

热键支持库

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

路径:支持库 → 热键支持库 → 全局热键。

硬约束

  1. 扁平命令;注册后全局有效(窗口不在前台也可触发)。
  2. 修饰键标志:Alt=1,Ctrl=2,Shift=4,Win=8,可相加(如 Ctrl+Shift=6)。
  3. 键码为虚拟键码整数(如 A=65,F1=112)。
  4. 回调须为无参子程序,建议 &函数名。
  5. 注册热键 成功返回 ID>0,失败返回 0。
  6. 退出前可 注销热键 / 注销全部热键。

快速开始

整数 热键ID = 0
函数 按下CtrlShiftA() {
    输出("全局热键 Ctrl+Shift+A")
}
启动() {
    热键ID = 注册热键(6, 65, &按下CtrlShiftA)
    如果 (热键ID == 0) { 警告框("注册失败") }
}

全局热键

本分类共 4 条。

注册热键

  • 签名:整数 注册热键(整数 修饰键, 整数 键码, 子程序指针 回调)
  • 说明:注册全局热键;按下组合键时调用回调。成功返回热键 ID(大于 0),失败返回 0。
  • 参数一│修饰键: Alt/Ctrl/Shift/Win 标志相加
  • 参数二│键码: 虚拟键码
  • 参数三│回调: 热键按下时执行的函数,建议 &函数名

注销热键

  • 签名:逻辑 注销热键(整数 热键ID)
  • 说明:注销此前 注册热键 返回的单个热键。
  • 参数一│热键ID: 注册热键 的返回值

注销全部热键

  • 签名:无 注销全部热键()
  • 说明:注销本程序通过 注册热键 登记的全部热键。

热键是否已注册

  • 签名:逻辑 热键是否已注册(整数 修饰键, 整数 键码)
  • 说明:判断本程序是否已注册指定修饰键+键码组合(不含其他程序占用情况)。
  • 参数一│修饰键
  • 参数二│键码

易错对照

错误 正确
修饰键当名字直接传 用整数标志相加
回调有参数 必须无参;&函数名
返回 0 当成功 0=失败

相关

键盘支持库 · 回调