跳到主要内容

按键操作

读取单个键盘或鼠标键的按下、锁定状态,或按下 / 抬起某个键。要连续发送一串按键,用 模拟按键B;要等用户按某键,用 等待按键

当前模块定义

sys:keyoperationWindows系统Action
标准模块
输入 4 · 输出 2 · 枚举 1

输入参数

  • 类型typeEnum必填

    操作类型。按下和抬起需要配对使用。

    填写 固定输入默认 get_key_state
    5 个选项获取按键状态、按下按键、抬起按键
    获取按键状态默认get_key_state
    按下按键key_down
    抬起按键key_up
    按下Quicker虚拟键V1key_keydown_v1
    抬起Quicker虚拟键V1key_keyup_v1
  • 按键keyText可选

    要操作或检查状态的按键(单个)。获取状态可使用鼠标键;如需发送真实鼠标事件,请使用“鼠标输入”步骤。

    填写 输入或变量条件 排除:key_keydown_v1, key_keyup_v1
  • 获取按键的实际状态(在远程时无法获取)getRealMouseStateBoolean可选
    填写 固定输入条件 仅:get_key_state默认 false
  • 保持按下时间keepMsInteger可选

    保持此虚拟键按下的时间(毫秒数),之后会自动抬起。

    填写 输入或变量条件 仅:key_keydown_v1默认 1000

输出参数

  • 是否按下isDownBoolean

    此按键是否为按下状态

    条件 仅:get_key_state
  • 是否锁定isToggledBoolean

    此按键是否为锁定状态,仅对CapsLock、NumLock等按键有效。

    条件 仅:get_key_state

概述

常见用途:动作开头根据是否按住某键切换功能;读 CapsLock 再设成需要的状态;模拟一直按住某个键。

按键操作

单个键盘按键的操作控制或状态获取
类型
操作类型。按下和抬起需要配对使用。
按键
 
要操作或检查状态的按键(单个)。获取状态可使用鼠标键;如需发送真实鼠标事件,请使用“鼠标输入”步骤。
是否按下
-- 选择变量 --
此按键是否为按下状态
是否锁定
-- 选择变量 --
此按键是否为锁定状态,仅对CapsLock、NumLock等按键有效。

参数说明

类型:获取按键状态、按下按键、抬起按键、按下 Quicker 虚拟键 V1、抬起 Quicker 虚拟键 V1。按下和抬起需要配对。

按键:要读取或操作的单个键名或虚拟键码。获取状态时可用鼠标键;要发送真实鼠标事件,用 鼠标输入。键名说明见 等待按键。获取按键状态、按下、抬起时显示。

获取按键的实际状态(在远程时无法获取):仅 获取按键状态。默认关闭。

保持按下时间:仅 按下 Quicker 虚拟键 V1。保持按下的毫秒数,到期自动抬起。默认 1000

输出

获取按键状态

  • 是否按下:该键是否处于按下状态。
  • 是否锁定:是否处于锁定状态,仅对 CapsLock、NumLock 等有效。

限制与排障

若该键被设成扩展热键,或被 Quicker 用作触发功能的鼠标键,按键消息会被拦截,本模块会读不到。只检测没有被 Quicker 特殊处理的键。远程桌面里「实际状态」可能拿不到。

相关链接

更新于