Releases: Zalafina/QKeyMapper
Releases · Zalafina/QKeyMapper
Update to v1.3.8.20260110
[按键映射工具] [游戏工具] QKeyMapper
💡 Win10及Win11系统推荐使用 Qt6_x64 版本release包，只有无法使用Qt6版本的Win7系统需要使用Qt5版本release包。点击👆上方三种颜色区分的最新版本zip压缩包名称可以直接下载对应版本最新release包。
- v1.3.8(Build 20260110)
- "映射项设定"窗口中"映射按键"和"抬起映射"单行编辑框后面添加 序列编辑 按钮，可以对当前按键序列分割成多行进行编辑，编辑结束后点击"确定"按钮将编辑后的多行内容按排序组合后更新回对应的单行编辑框内。
映射序列编辑操作说明
键盘按键↑/按键↓ -> 当前表格中高亮选择位置上下移动，配合键盘Shift键可以进行多选。 键盘按键Home/End -> 当前表格中高亮选择位置移动到表格顶部或底部。 键盘按键Backspace -> 取消当前表格中高亮选择。 键盘按键F2 -> 如果表格中存在当前单元格，当前单元格进入编辑状态。 键盘按键Ctrl+↑/↓ -> 当前表格中高亮选择行在表格中上下移动。 键盘按键Ctrl+Home/End -> 当前表格中高亮选择行移动到表格顶部或底部。(与 **键盘按键Ctrl+Shift+↑/↓** 效果相同) 键盘按键Delete -> 删除当前表格中高亮选择行。(与表格右侧 **删除** 按钮功能相同) 键盘按键Enter -> 如果当前表格中仅高亮选择一行，则将此行内容读取到下方映射按键单行编辑框中。 下方插入按钮 -> 如果映射按键单行编辑框内容验证有效则将编辑框中内容插入表格中高亮选择位置，没有高亮选择状态将内容插入到表格末尾。(表格中允许插入空行) 键盘按键Ctrl+C -> 复制当前表格中高亮选择行。 键盘按键Ctrl+V(单行) -> 如果仅复制了一行内容，并且当前表格中仅高亮选择一行，直接用复制内容替换高亮选择行内容。当前高亮选择多行内容时，在高亮选择位置插入复制的单行内容。没有高亮选择状态将此单行内容插入到表格末尾。 键盘按键Ctrl+V(多行) -> 如果复制了多行内容，根据当前表格中高亮选择位置插入复制的多行内容，没有高亮选择状态将多行内容插入到表格末尾。 键盘按键Ctrl+F -> 与Ctrl+V功能类似，也是根据表格中高亮选择位置插入复制内容，但是没有Ctrl+V的单行对单行替换功能，复制单行且高亮选择单行时候也执行高亮位置插入动作。 键盘按键Ctrl+Z -> 撤销上一次表格内容修改，回到上一次修改前状态，仅记录最近20次表格修改，映射序列编辑窗口退出时清空表格修改记录。(与表格右侧 **撤销** 按钮功能相同) 键盘按键Ctrl+Y -> 恢复上一次表格内容修改，回到上一次撤销前状态。(与表格右侧 **恢复** 按钮功能相同) - 映射按键列表中添加 Mouse-Move_Relative 映射键，选择此映射按键点击添加映射时需要在参数输入框读取"delta_x,delta_y" 形式的参数。或者自己编辑"Mouse-Move:R(delta_x,delta_y)" 形式的鼠标指针相对位移映射。
鼠标指针相对位移使用示例
Mouse-Move:R(6,10) -> 基于当前指针位置，x增大6，y增大10。 Mouse-Move:R(-6,-10) -> 基于当前指针位置，x减小6，y减小10。 Mouse-Move:R(0,8) -> 基于当前指针位置，x不变，y增大8。 Mouse-Move:R(-2,0) -> 基于当前指针位置，x减小2，y不变。 - KeySequenceBreak 功能扩展：支持 "KeySequenceBreak(原始按键)" 形式，用于仅打断指定原始按键对应的运行中按键序列；不带括号时仍然打断所有当前运行中的按键序列。
- active_window.ahk 脚本添加 loopSwitch 参数，默认 loopSwitch=true 存在多个符合激活匹配条件的窗口时，循环进行切换激活。如果希望固定激活第一个匹配窗口则在参数中追加 loopSwitch=false
- "映射项设定"窗口中"映射按键"和"抬起映射"单行编辑框后面添加 序列编辑 按钮，可以对当前按键序列分割成多行进行编辑，编辑结束后点击"确定"按钮将编辑后的多行内容按排序组合后更新回对应的单行编辑框内。
- v1.3.8(Build 20260102)
- 分类筛选功能支持多选。
- 修复特定场景下映射表Tab进行切换时程序崩溃退出问题。
- 映射表中允许存在相同原始按键的映射，但是相同原始按键映射同一时间只有一条能处于启用状态。
- 启用映射时如果当前映射表中存在重复的已启用映射，之前启用的重复映射会被禁用。
- 添加、复制、导入的映射如果当前映射表已经存在重复映射，添加、复制、导入的重复映射会被自动设置为禁用。
- utils目录下工具脚本追加，详细使用方法参考 utils 目录下 readme.txt 文件:
窗口大小和位置调整工具EX
ahk.exe winmove_ex.ahk process="notepad.exe" title="记事本" w=800 h=600 (窗口大小调整为 800 x 600) ahk.exe winmove_ex.ahk process="notepad.exe" title="记事本" x=100 y=200 (窗口左上角坐标位置移动到x=100, y=200) ahk.exe winmove_ex.ahk process="notepad.exe" title="记事本" x=100 y=200 w=800 h=600 (移动到x=100,y=200并调整大小为 800 x 600) ahk.exe winmove_ex.ahk process="notepad.exe" title="记事本" w=800 h=600 center (按新尺寸居中显示) ahk.exe winmove_ex.ahk process="notepad.exe" title="记事本" w=800 h=600 center active=true (居中并激活窗口) - 添加 active_window.ahk 和 winmove_ex.ahk 的标题参数可以支持空标题窗口，process="xxx.exe" title=""
Update to v1.3.8.20251228
[按键映射工具] [游戏工具] QKeyMapper
💡 Win10及Win11系统推荐使用 Qt6_x64 版本release包，只有无法使用Qt6版本的Win7系统需要使用Qt5版本release包。点击👆上方三种颜色区分的最新版本zip压缩包名称可以直接下载对应版本最新release包。
- v1.3.8(Build 20251228)
- "通用设定"标签页中添加"编辑模式"下拉选择框，可以选择"右键双击"或"左键双击"方式进入映射表单元格编辑状态，默认是"右键双击"。
- 选择"右键双击"时，使用鼠标右键双击(或者Alt键+左键双击)映射表单元格的方式进入单元格编辑状态。此时鼠标左键双击映射项显示"映射项设定"窗口。
- 选择"左键双击"时，使用鼠标左键双击映射表单元格的方式进入单元格编辑状态。此时鼠标右键双击(或者Alt键+左键双击)映射项显示"映射项设定"窗口。
- "映射宏列表"中高亮选择内容后按下 Ctrl+C 可以复制当前选中内容，之后按下 Ctrl+V 可以在当前宏列表插入复制的内容，如果存在相同宏名则尝试以"<宏名>_副本"的宏名插入复制内容。
- 按键映射表和映射宏列表左侧加入行号显示。
- 映射表 映射按键 列的提示框信息加入 发送时机 和 抬起映射 显示。
- 映射项设定 窗口内 映射按键列表 添加按键序列使用的 » 符号。
- 勾选 启动时自动开始 时，启动加载设定显示问题修复。
- "通用设定"标签页中添加"编辑模式"下拉选择框，可以选择"右键双击"或"左键双击"方式进入映射表单元格编辑状态，默认是"右键双击"。
- v1.3.8(Build 20251222)
- 映射表中"原始按键"和"映射按键"列单元格鼠标左键双击进入可编辑状态。
- 显示"映射项设定"窗口从鼠标左键双击变为下面几种方式：
- 鼠标右键双击映射表中条目显示"映射项设定"窗口。
- 按住Alt按键后鼠标左键双击映射表中条目显示"映射项设定"窗口。
- 鼠标点击等方式高亮选中映射表中一行后，按下键盘回车键显示"映射项设定"窗口。
- 映射表添加"禁用"列，勾选"禁用"勾选框后开启映射时此条映射不生效。
- 原始按键列表中添加SendOnMappingStop原始按键，当此映射表停止映射时会执行映射内容。
※可尝试用于非按键发送的映射内容，但不建议使用SendOnMappingStop发送按键，容易引发按键无法释放等异常问题。 - 设定导出列表显示的图标支持显示自定义图标。
- v1.3.8(Build 20251216)
- "窗口信息"标签页添加"选择自定义图标"按钮，可以设置当前设定名称对应的自定义图标显示，支持 .ico/.png/.svg 后缀。
- 选择自定义图标文件后，如果图标文件存在的情况，会优先尝试加载自定义图标文件。
- 按下L-Ctrl键点击"选择自定义图标"按钮，会清除当前设置的自定义图标，根据双击左侧进程列表时设置的进程路径或者手动设置的进程路径来尝试加载进程可执行文件中的图标。
- 设置自定义图标后需要点击"保存设定"按钮存储，否则切换设定会清除未保存的自定义图标路径。
- 映射项设定窗口添加"发送方式"下拉列表框，可以选择"SendInput"、"SendMessage"、"FakerInput"三种发送方式。默认使用"SendInput"发送方式，没有特殊需求大部分场景全都建议选择此方式，兼容性和稳定性最好。
- "FakerInput"发送方式通过FakerInput虚拟键鼠驱动来发送HID键鼠消息，比Windows SendInput API更接近物理键鼠消息，由于使用上有功能限制，没有特殊需要不必选择此发送方式。
- 使用"FakerInput"发送方式需要先在"映射设定"标签页点击"安装FakerInput驱动"按钮安装驱动程序，上方状态显示绿字"FakerInput可用"，表示驱动安装成功。
- 驱动程序安装成功添加提示信息。
- 映射项设定窗口移除"SendMessage发送"勾选框，可以使用"发送方式"功能替代。
- 修复映射时机选择抬起时与长按映射方式触发重叠问题。
- utils目录下工具追加，详细使用方法参考 utils 目录下 readme.txt 文件：
IME输入法切换工具
注意：可用参数-> ime=0xXXXXXXXX : 输入法编码(HKL值，必需，十六进制格式) mode=模式 : 设置输入法模式 (可选) 通用模式: mode=off / english : 关闭输入法(英文模式) mode=on / native : 开启输入法(本地语言模式) 中文输入法: mode=chinese : 中文模式(可输入汉字) 日文输入法: mode=hiragana : 平假名模式(ひらがな) mode=katakana : 全角片假名模式(カタカナ) mode=katakana_half : 半角片假名模式(ｶﾀｶﾅ) mode=alphanumeric : 全角英数模式(ＡＢＣ) 工具命令示例-> ahk.exe switch_ime.ahk ime=0x04090409 (切换到英文键盘) ahk.exe switch_ime.ahk ime=0x08040804 (切换到中文拼音-保持之前中英文模式) ahk.exe switch_ime.ahk ime=0x08040804 mode=chinese (中文拼音-中文模式) ahk.exe switch_ime.ahk ime=0x08040804 mode=english (中文拼音-英文模式) ahk.exe switch_ime.ahk ime=0x04110411 (切换到日文输入法-保持之前输入模式) ahk.exe switch_ime.ahk ime=0x04110411 mode=hiragana (日文输入法-平假名) ahk.exe switch_ime.ahk ime=0x04110411 mode=english (日文输入法-英文模式) ahk.exe switch_ime.ahk ime=0x04110411 mode=katakana (日文输入法-全角片假名) ahk.exe switch_ime.ahk ime=0x04110411 mode=katakana_half (日文输入法-半角片假名)- HKL编码可能因系统版本和安装的语言包不同而有所差异
- 切换的输入法必须已在系统中安装，否则切换无效
- Windows 10/11 系统可在 设置 -> 时间和语言 -> 语言 中添加输入法
- "窗口信息"标签页添加"选择自定义图标"按钮，可以设置当前设定名称对应的自定义图标显示，支持 .ico/.png/.svg 后缀。
- v1.3.8(Build 20251206)
- 映射宏列表添加备份功能，可以将当前显示的宏列表中高亮选择的宏导出到INI文件中(列表支持多行连续选择)。
※选择宏列表导入时，导入项目追加在列表末尾。如果有重复的宏名会提示用户是否覆盖，选择"是"会删除当前列表中同名宏，将从文件导入的宏列表全部追加在末尾。选择"否"保留当前列表中同名宏，仅从文件中导入不同名的宏。 - 映射宏列表添加"备注"功能。
- 映射宏列表添加"删除"按钮。
- 映射项设定窗口添加"PasteText模式"选择，有"Shift+Insert"和"Ctrl+V"两种模式选择，默认是"Shift+Insert"模式，大部分情况选择默认即可。
- 映射按键编辑框字符数最大长度限制从32767增大到100万。
- 映射宏列表添加备份功能，可以将当前显示的宏列表中高亮选择的宏导出到INI文件中(列表支持多行连续选择)。
Update to v1.3.8.20251130
[按键映射工具] [游戏工具] QKeyMapper
💡 Win10及Win11系统推荐使用 Qt6_x64 版本release包，只有无法使用Qt6版本的Win7系统需要使用Qt5版本release包。点击👆上方三种颜色区分的最新版本zip压缩包名称可以直接下载对应版本最新release包。
- v1.3.8(Build 20251130)
- 映射设定标签页中添加"映射宏列表"按钮，点击进入"映射宏列表"窗口可以添加当前设定项使用的"宏"或者所有设定项都可以使用的"通用宏"。
映射宏的编写格式与映射按键内容相同，"映射宏列表"添加的"宏"和"通用宏"分别使用Macro(宏名)x循环次数、UniversalMacro(通用宏名)x循环次数的方式插入到映射按键中使用，不添加循环次数时宏只发送一次。
"宏"标签页的宏列表，每个设定项各自独立。"通用宏"标签页的通用宏列表，映射软件内所有设定项共用。映射宏使用示例
Macro(宏A) UniversalMacro(通用宏B)x3 A⏱300»Macro(宏C)x2 - 映射按键列表中添加 PasteText 映射键，选择PasteText后在"参数"编辑框中输入文字可以在按下原始按键时使用剪贴板粘贴方式发送 PasteText(...) 括号内的字符串。
※Paste(...)方式对粘贴大量文本速度比较快，但是有可能某些程序不支持剪贴板或者剪贴板粘贴快捷键不是Ctrl+V，则无法正常正常使用 - "Block-Keyboard" 和 "Block-Mouse" 修改为不屏蔽通过软件发送的虚拟映射按键。
- 修复鼠标操作包含坐标点的映射键不支持扩展屏幕上负数坐标值。
- 修复设定备份仅导出"通用设定"时，无法正常导入的问题。
- 映射设定标签页中添加"映射宏列表"按钮，点击进入"映射宏列表"窗口可以添加当前设定项使用的"宏"或者所有设定项都可以使用的"通用宏"。
- v1.3.8(Build 20251108)
- 映射键列表中添加 "Block-Keyboard" 和 "Block-Mouse" 映射键, 发送映射映射按键按下时禁用键盘或鼠标输入。
※使用Block-Mouse禁用鼠标请提前记住映射停止快捷键(默认L-Ctrl+F6)，避免鼠标无法操作后无法停止映射键盘鼠标输入设备禁用
Block-Keyboard - 禁用映射表和快捷键以外的所有键盘输入 Block-Keyboard⌨ - 功能与Block-Keyboard相同，只是会显示禁用键盘和启用键盘的提示信息 Block-Mouse - 禁用映射表和快捷键以外的所有鼠标输入 Block-Mouse🖱 - 功能与Block-Mouse相同，只是会显示禁用鼠标和启用鼠标的提示信息 - "映射设定"标签页的"映射高级设定"对话框中添加游戏手柄扳机键和摇杆触发和释放阈值设定。
※默认值按下50%，释放15%即可正常检测，修改后有可能无法正常检测触发，没有特殊需要不要随意更改。
- 映射键列表中添加 "Block-Keyboard" 和 "Block-Mouse" 映射键, 发送映射映射按键按下时禁用键盘或鼠标输入。
- v1.3.8(Build 20251102)
- 修复映射高级设定中"垂直鼠标速度"设定无效问题。
- 修复Ctrl/Alt/Shift/Win键组合键映射兼容性问题。
- v1.3.8(Build 20251024)
- utils目录下工具脚本追加，详细使用方法参考 utils 目录下 readme.txt 文件 (utils工具策略变为直接使用Autohotkey的.ahk脚本) ：
窗口大小和位置调整工具
ahk.exe winmove.ahk wintitle="记事本" w=800 h=600 (窗口大小调整为 800 x 600) ahk.exe winmove.ahk wintitle="记事本" x=100 y=200 (窗口左上角坐标位置移动到x=100, y=200) ahk.exe winmove.ahk wintitle="记事本" x=100 y=200 w=800 h=600 (窗口左上角坐标位置移动到x=100, y=200的同时窗口大小调整为 宽度=800, 高度=600) ahk.exe winmove.ahk wintitle="记事本" center (窗口在当前屏幕居中显示) - SetVolume功能增强
🔊播放设备音量控制
SetVolume(35.5) - 设置播放设备风音量为 35.5% SetVolume(+10) - 增加 10% SetVolume(-5.5) - 减少 5.5% SetVolume(Mute) - 切换播放设备静音状态 SetVolume(MuteOn) - 设置为静音 (如已静音则不动作) SetVolume(MuteOff) - 取消静音 (如未静音则不动作) SetVolume🔊(...) - 与上面功能相同，带提示的播放设备音量控制🎤录音设备音量控制
SetMicVolume(50.5) - 设置麦克风音量为 50.5% SetMicVolume(+10) - 增加 10% SetMicVolume(-5.5) - 减少 5.5% SetMicVolume(Mute) - 切换麦克风静音状态 SetMicVolume(MuteOn) - 设置麦克风静音 SetMicVolume(MuteOff) - 取消麦克风静音 SetMicVolume🎤(...) - 与上面功能相同，带提示的麦克风音量控制 - 虚拟手柄设定标签页添加鼠标控制虚拟手柄摇杆的 X轴反转 和 Y轴反转 勾选框。
- 匹配条件都满足时，窗口内鼠标位置点击生效窗口根据前台窗口切换更新。
- utils目录下工具脚本追加，详细使用方法参考 utils 目录下 readme.txt 文件 (utils工具策略变为直接使用Autohotkey的.ahk脚本) ：
- v1.3.8(Build 20251018)
- 映射项设定对话框中映射按键编辑时支持
Repeat{映射内容}x循环次数的写法，循环次数范围 1~99999。映射循环示例
Repeat{A⏱50}x5 Repeat{B+C}x3 A⏱50»Repeat{C+D»E⏱50}x2»F - 鼠标操作包含坐标点的映射键添加支持扩展屏幕，包括：Mouse-Move、Mouse-L/R/M/X1/X2、Mouse-PosSave、Mouse-PosRestore等。
- PS4虚拟手柄映射按键添加"vJoy-Touchpad"按键，对应PS4手柄触摸板键。
- utils目录下工具追加，详细使用方法参考 utils 目录下 readme.txt 文件：
1. 窗口状态更改工具
config_window.exe opacity=XXX (改变鼠标指针指向的窗口或者当前前台窗口的不透明度，可以增加减少也可以设定确定值，范围20~255) config_window.exe alwaysontop (当前鼠标指针指向的窗口或者当前前台窗口切换置顶状态) config_window.exe passthrough (当前鼠标指针指向的窗口或者当前前台窗口切换鼠标穿透状态) 注意：如果置顶和鼠标穿透切换无效，尝试鼠标点击任务栏选择此窗口让此窗口变为前台窗口后再进行切换通常会有效。2. 窗口位置移动工具
move_window.exe start (启动窗口位置拖动，启动后当前鼠标指针指向的窗口跟随鼠标指针移动进行位置移动) move_window.exe stop (停止窗口位置拖动，停止之后窗口不再跟随鼠标指针位置移动) 启动窗口位置拖动过程中，按下 Esc 键会回到开始拖动之前的窗口位置。
- 映射项设定对话框中映射按键编辑时支持
Update to v1.3.8.20251012
[按键映射工具] [游戏工具] QKeyMapper
💡 Win10及Win11系统推荐使用 Qt6_x64 版本release包，只有无法使用Qt6版本的Win7系统需要使用Qt5版本release包。点击👆上方三种颜色区分的最新版本zip压缩包名称可以直接下载对应版本最新release包。
- v1.3.8(Build 20251012)
- 窗口信息标签页添加窗口监测"忽略规则列表"，可以指定窗口的进程、标题、类名等信息的匹配规则来忽略对此窗口的检测。忽略的窗口不会出现在进程列表中，切换到此窗口也不会改变当前映射状态。
- 映射设定标签页内"映射高级设定"窗口中加入"显示窗口内坐标点"和"显示屏幕内坐标点"按键自定义功能，初始默认设置分别为"F8"和"F9"。
- 添加保存当前鼠标指针位置和恢复到之前保存鼠标指针位置映射键，"Mouse-PosSave" 和 "Mouse-PosRestore"。映射按键示例：
Mouse-PosSave»Mouse-L(300,200)»Mouse-PosRestore - 映射按键按下时长支持范围设置，
A⏱(50~70)表示按键A按下时长在50毫秒~70毫秒之间取随机值。 - 修复setVolume在切换了当前输出设备后更改的仍然是之前输出设备音量的问题。
- release版本zip压缩包路径添加AHK编写的utils工具，详细使用方法参考 utils 目录下 readme.txt 文件：
- 窗口切换工具：Run命令使用格式：active_window.exe process="notepad.exe" title="新建文本文档" launch=true
- 鼠标指针位置保存恢复工具：mouse_position.exe save=XXX、mouse_position.exe restore=XXX (save将当前鼠标指针位置存储为XXX名称，XXX名称可以自定义。restore从之前存储的鼠标指针位置中查找XXX名称对应的坐标点进行恢复)
- v1.3.8(Build 20251006)
- 窗口信息标签页增加"窗口类名"匹配功能，"窗口类名"默认是忽略状态，需要匹配时改变匹配规则下拉列表选择即可。
- 增加对窗口标题为空和受保护进程的路径无法读取的兼容性。
- 修复按住L-Ctrl点击"添加Tab按钮"复制当前Tab时，悬浮窗口穿透切换键没有复制的问题。
- v1.3.8(Build 20250926)
- 进程和标题的匹配方式添加 "正则匹配"，使用此匹配方式会根据进程和标题单行编辑框中的正则表达式内容进行进程和标题的匹配。使用"正则匹配"输入内容后可以按下回车检验正则表达式有效性，无效时会提示"无效的正则表达式 : ..."。
- 映射键列表中添加 "QKeyMapper-Fn" 映射键，先按下此映射键后再按映射表中其他原始按键可以切换映射的连发和锁定状态，切换顺序：正常->连发->连发+锁定->正常。映射项设定窗口中可以对某个映射项禁用此Fn键切换功能。
- 映射键列表中添加 "SetVolume🔊" 映射键，使用此映射键设置系统当前播放设备音量值同时会通过提示信息方式显示设置后音量值。
- 长按和双击映射项使用"发送时机"的问题修复。
- v1.3.8(Build 20250920)
- 原始按键列表中添加 "SendOnMappingStart"和"SendOnSwitchTab" 两个原始按键。
- "SendOnMappingStart"原始按键，当从此映射表开始映射时会发送映射按键内容。
- "SendOnSwitchTab"原始按键，当使用Tab快捷键或SwitchTab映射切换到此映射表时会发送映射按键内容。
- 映射键列表中添加 "SetVolume" 映射键, 可使用此映射键添加 "SetVolume(...)" 形式的映射键来控制系统当前播放设备的音量。音量值范围 0～100，允许小数点后两位精度。
音量设置映射键使用示例：
SetVolume(10) (音量设置为10) SetVolume(+5) (当前音量基础上增加5，最大不会超过100) SetVolume(-20) (当前音量基础上减少20，最小不会小于0) SetVolume(30.8) (音量设置为30.8，系统UI会进行round四舍五入显示31) - 导入导出设定对话框中显示和操作方式优化。
- 添加"映射高级设定"按钮，按下后显示"映射高级设定"对话框窗口。
- "水平鼠标速度"、"垂直鼠标速度"、"进程图标作为托盘图标"、"接受虚拟手柄输入" 设定项移动到"映射高级设定"对话框窗口内。
- 添加鼠标移动"轮询间隔"，手柄摇杆控制鼠标指针移动或键盘按键控制鼠标指针移动可以通过增大"轮询间隔"时间进一步降低指针移动速度。默认值"2毫秒"，设定范围1~99毫秒。
- 原始按键列表中添加 "SendOnMappingStart"和"SendOnSwitchTab" 两个原始按键。
- v1.3.8(Build 20250912)
- 映射键列表中添加 "Unlock" 映射键, 可使用此映射键添加 "Unlock(...)" 形式的映射键来对指定的原始按键锁定状态进行解锁。例如：A->B (锁定)，C->Unlock(A)。第一次按下A键抬起后进入持续按下B键的锁定状态后，可以通过按下C键来解锁原始按键A锁定，解除持续按下B键状态。
- 映射项设定窗口中添加 "禁用原始按键解锁" 勾选框，勾选后对于设置了锁定功能的按键映射，原始按键按下只会进行锁定，无法通过按下原始按键来进行解锁。只能通过 "Unlock" 映射键或者停止映射来解除按键锁定状态。
- 添加映射表切换记忆功能。
- 双击映射表名称Tab设置Tab切换快捷键可以添加前缀"💾"，则映射过程中使用快捷键切换到此Tab时候，会记录保存此Tab名，下一次切换到此设定时候会显示此Tab名。
- 映射键列表中添加 "SwitchTab💾" ，使用此映射键切换映射表时候会记录保存此Tab名，下一次切换到此设定时候会显示此Tab名。
- 手动操作映射停止时，如果当前自动切换到了全局映射设定，软件会尝试切换回20秒内自动匹配前台窗口切换过的最后一个设定，让用户可以直接对此设定进行修改编辑。
- v1.3.8(Build 20250906)
- 主窗口设定名称编辑框右侧加入"备份"按钮，点击时弹出"设定导入"、"设定导入"扩展按钮。设定导出窗口列出
- "设定导出"对话框中可以选择和编辑导出的INI文件名，默认是软件目录下的"setting_export.ini"文件。注意如果选择已经存在的INI文件，不会清空此文件，而是会将选择导出的设定与当前INI文件中内容进行覆盖追加。所以想要全新导出不是追加方式的话应该选择不存在的新文件名。
- "设定导入"对话框中可以选择和编辑导入的INI文件名，此INI文件中如果有当前文件中已存在设定名称会用特殊颜色文字显示。选择相同名称设定导入会对当前设定文件中同名设定数据进行覆盖。
- "全选"用于全部选择或者全部取消选择。
- "通用设定"是软件中"通用设定"标签页中跟设定名称无关的软件基本功能设定数据，导入通用设定后如果某些通用设定未立即生效可以手动退出重启软件重新加载设定文件。
- "设定导入"会修改和覆盖当前设定文件数据，建议先备份keymapdata.ini原设定文件后再进行操作，避免意外覆盖数据或文件出错的情况导致设定丢失。
- 悬浮窗口显示位置和透明度调整后按住L-Ctrl+鼠标左键双击悬浮窗口会保存设定。
- 虚拟手柄设定中，"X轴灵敏度"和"Y轴灵敏度"可以设置为0。设置为0时，鼠标移动时虚拟手柄摇杆在水平方向或者垂直方向完全不会发生摇杆偏移。
- 界面图标颜色修改，在深色和浅色模式下对比度区分更明显。
- 两个保存过的前台窗口之间切换时，映射设定切换效果优化。
- 映射表设定窗口中添加"不显示提示信息"三态勾选框，可以让单个Tab映射表选择开始映射此Tab时不显示提示信息，或者开始映射和切换Tab到此Tab映射表都不显示提示信息。
- "映射更新"按钮对双击和长按原始按键检查规则问题修复。
- 主窗口设定名称编辑框右侧加入"备份"按钮，点击时弹出"设定导入"、"设定导入"扩展按钮。设定导出窗口列出
Update to v1.3.8.20250830
[按键映射工具] [游戏工具] QKeyMapper
- v1.3.8(Build 20250830)
- 添加"SwitchTab"映射键用于使用映射方式指定Tab映射表名称进行切换。
- 设定选择列表中选择第一条空白项时候Tab映射列表清空，设定项恢复初始默认值。
- "映射项设定"窗口中按键映射字符串内容修改后更新方式优化。
- 增加"启动位置设定"窗口可以选择程序启动时窗口位置。
- 设置了快捷键的Tab名称使用青绿色文字显示，代替前缀★。
- "映射表自定义图片"增加".svg"后缀的SVG图片支持。
- 按键捕获编辑框中按下Tab和Shift+Tab按键不会切换焦点到其他控件。
- v1.3.8(Build 20250824)
- 添加"Run"映射键用于将按键映射到特定命令执行。
- "Run(E:\ABC\def\XYZ\abcd.exe param1 param2 [WorkingDir="<dir_path>"] [ShowOption=Max|Min|Hide])" 可以运行指定的命令，并且可以通过空格指定执行参数。
- 可以加入特定参数指定运行状态：
- WorkingDir="C:\Path With Spaces" 指定工作目录。必须使用双引号包裹包含空格的路径；会校验目录是否存在。
- ShowOption=Max|Min|Hide 启动窗口显示模式：Max（最大化）、Min（最小化）、Hide（隐藏）。若不指定默认正常显示(注意不是所有程序都支持这些ShowOption参数)。
- 支持在命令开头指定系统动作，系统动作列表如下：
- find(查找)
- explore(用资源管理器打开)
- open(打开文件)
- edit(用默认编辑器编辑)
- openas(选择程序打开)
- print(打印)
- properties(显示文件属性)
- runas(管理员权限运行)
- SendText增加多行文本支持。
- 修正"Crosshair"十字准星映射显示时候不应该抢夺当前窗口焦点问题。
- 添加"Run"映射键用于将按键映射到特定命令执行。
- v1.3.8(Build 20250816)
- "映射设定"标签页中添加"开启系统筛选键"勾选框，勾选状态下此套映射设定开始映射时如果系统没有开启筛选键，程序会自动开启系统筛选键，映射结束后会自动恢复映射开始前的系统筛选键关闭状态。此勾选框默认未勾选状态，取消勾选会弹出消息提示框让用户确认是否确定不希望映射中自动开启系统筛选键。
- 设定列表中全局映射设定名称显示为"全局按键映射"。
- 映射表设定窗口中添加"按键记录区"编辑框，点击此编辑框获得焦点后按下的单个按键和组合键会被记录显示在编辑框中。
- 点击后面"按键编译/按键捕获"记录编辑模式切换按钮可以在按键捕获和手动编辑两种模式之间进行切换。
- 鼠标右键点击编辑模式切换按钮可以将当前"按键记录区"编辑框内容追加到原始按键或映射按键编辑框末尾(按下L-Ctrl后鼠标右键点击按钮追加到映射按键编辑框末尾)。
- v1.3.8(Build 20250812)
- "通用设定"添加"外观颜色"下拉选择列表，可以选择"浅色"、"深色"、"系统默认"。系统默认跟随Windows系统颜色深浅改变界面外观颜色深浅。
- 添加"原始键记录"编辑框，点击此编辑框获得焦点后按下的单个按键和组合键会被记录显示在编辑框中。
- 点击后面"按键编译/按键捕获"记录编辑模式切换按钮可以在按键捕获和手动编辑两种模式之间进行切换。
- 点击"添加"按钮时，优先检查"原始键记录"编辑框中内容，"原始键记录"编辑框空白时再检查原始按键列表选择内容。
- 操作提示信息和映射状态提示信息显示修改为鼠标穿透效果。
- v1.3.8(Build 20250808)
- 物理手柄按键检测添加新支持按键。
新支持的按键列表：
Joy-Misc1 (PS5 麦克风键，SwitchPro capture键， Amazon Luna 麦克风键，Xbox X share键) Joy-Paddle1 (1号背键) Joy-Paddle2 (2号背键) Joy-Paddle3 (3号背键) Joy-Paddle4 (4号背键) Joy-Touchpad (PS4/PS5 触摸板键) ※Windows平台由于Xbox布局手柄默认走XInput输入，只有切换到Dinput模式才有可能检测到特殊按键，PS手柄和Switch手柄默认使用DInput所以可以检测到。 - 物理手柄按键检测方式优化，PS4/5手柄按键检测名称与Xbox手柄保持一致。
- 原始按键列表控件获得焦点状态下(例如通过滚轮或鼠标点击操作获得焦点时)，按下物理手柄按键，原始按键列表会自动切换为按下的手柄按键名称。
- 检测Windows系统设置了默认应用模式为"暗色"时，仍然保持用"亮色"显示QKeyMapper程序界面。
- 修复设置提示信息不显示时，悬浮窗口也不显示问题。
- 修复更改Tab名称时候Tab标签显示更新问题。
- 移除程序默认的scale缩放设置，可以通过"通用设定"新增的"缩放比例"下拉列表选择程序显示缩放倍数，保存设定后下次程序启动时生效。需要注意"--scale="启动参数比程序内设定值优先级更高。
- 物理手柄按键检测添加新支持按键。
- v1.3.8(Build 20250806)
- "悬浮窗口设定"窗口内添加坐标基准点设置，默认基准点为"屏幕左上角"。可以选择以屏幕特定位置为基准点或者以匹配窗口的特定位置为基准点，配合坐标信息来确定悬浮窗口显示位置。
- "悬浮窗口设定"窗口内可以单独设置悬浮窗口的"背景色"和"圆角半径"。
- 按住L-Ctrl点击"添加Tab按钮"会将当前显示的Tab的内容完全复制到新追加的Tab，包括Tab自定义图片等各种Tab设定信息。
- 修复切换到不显示悬浮窗口的Tab时，悬浮窗口没有消去问题。
- "Post方式发送"修改为"SendMessage发送"。将PostMessage替换为SendMessage提高兼容性。
- v1.3.8(Build 20250802)
- "映射表设定"窗口中映射表自定义图片设定区域添加"显示为悬浮窗口"勾选框，勾选后匹配映射配置成功启用此Tab映射表会使用此自定义图片在屏幕上显示一个顶层悬浮窗口。
- 悬浮窗口显示中可以通过鼠标左键进行窗口拖拽移动悬浮窗口位置。
- 悬浮窗口显示中将鼠标指针移动窗口右下角，指针会变为改变窗口大小的样式，此时按下鼠标左键拖拽可改变悬浮窗口大小。悬浮窗口宽高比例固定为正方形，大小范围16~640。
- 鼠标指针在悬浮窗口内时候可以使用鼠标滚轮上下滚动可以调整窗口不透明度，上滚增大不透明度，下滚减小不透明度。不透明度范围0.10~1.00。
- "映射表设定"窗口中的"悬浮窗口设定"按钮点击弹出的"悬浮窗口设定"窗口中可以显示和调整当前悬浮窗口的大小、位置、不透明度、是否鼠标穿透。
- 勾选"鼠标穿透"勾选框后，悬浮窗口显示中无法用鼠标拖动、改变大小、调整不透明度。鼠标操作直接穿透到下层窗口。
- 悬浮窗口显示中，鼠标指针停留悬浮窗口内时，可以使用"F11"按键切换"鼠标穿透"状态。
- 点击"保存设定"对当前设定进行保存时会一起保存映射表的"悬浮窗口设定"，包括大小、位置、不透明度、是否鼠标穿透。
- "映射表设定"窗口的"托盘图标像素"下拉列表修改为从ICO图标文件读取各种不同尺寸的图标显示在列表中用于选择。
- "映射表设定"窗口中映射表自定义图片设定区域添加"显示为悬浮窗口"勾选框，勾选后匹配映射配置成功启用此Tab映射表会使用此自定义图片在屏幕上显示一个顶层悬浮窗口。
- v1.3.8(Build 20250728)
- 修复某些不提供高清图标的exe文件加载时提取图标尺寸不正确的问题。
- 程序目录下的"custom_trayicons"子目录如果存在".ico"图标文件，程序启动时会读取并添加到"选择系统托盘图标"窗口的列表末尾，可选择设置为不同状态的自定义托盘图标。
- "窗口信息"标签页中"进程"和"标题"内容可以设置为空，设置为空与匹配方式选择"忽略"相同，都会忽略进程或窗口标题检测。
- "进程"或"标题"内容为空时候前台窗口匹配处理完善。
- "发送到同名窗口"检测方式完善。
- v1.3.8(Build 20250726)
- 设定名称规则变化，添加"设定名称"单行编辑框，用户可以自定义编辑设定名称，列表中不存在的设定名称会保存时会添加新的设定。
- 点击保存时，设定名称如果与列表中已存在的名称相同会覆盖保存设定。
- 编辑修改设定中"进程"和"标题"内容及匹配方式等信息后，点击保存按钮才生效。
- 添加"窗口信息"标签页，窗口标题、进程名称、设定描述和进程图标都移动到此标签页显示。
- "窗口信息"标签页中可以选择进程和标题的匹配方式，包括："忽略"、"等于"、"包含"、"以...开头"、"以...结尾"。选择忽略与之前不勾选进程和标题勾选框效果相同。
- 双击左侧进程列表条目时，"进程"单行编辑框从显示进程文件名变为显示进程绝对路径，"进程"和"标题"单行编辑框都变为可编辑状态。
- 按住L-Ctrl双击左侧进程列表条目时，不但查找匹配当前已经存在的设定名称，同时也会也会当前进程列表的路径和窗口标题更新到"窗口信息"标签页中。
- 点击"恢复"按钮可以将"进程"编辑框内容恢复为进程绝对路径(如果存在的话)。
- "通用设定"标签页添加"启动时自动开始"勾选框，勾选后软件启动时自动切换为"映射开始"状态。不再需要使用"自动匹配前台进程"勾选框来达到启动后自动"映射开始"的效果。
- "移除设定"按钮按下后需要弹出对话框询问用户，按下确定按钮才移除选定的设定。
- "映射项设定"窗口中添加"固定虚拟键码"十六进制数值框，设定的数值如果不是0x0的话，发送键盘映射按键时会固定发送此虚拟键码，但是按键扫描码仍然按照键盘按键名称正常发送。
- 添加原始组合键支持对"Func-"前缀的功能性映射按键的进行映射。
- "提示信息高级设置"中显示时长设置为0时，最后显示的提示信息不消失。
- 修复"提示信息高级设置"窗口中未正确翻译的界面显示。
- 设定名称规则变化，添加"设定名称"单行编辑框，用户可以自定义编辑设定名称，列表中不存在的设定名称会保存时会添加新的设定。
※此版本设定保存和进程、标题的操作方式有变更，建议先下载新版本Release压缩包尝试后再选择是否更新版本。
- v1.3.8(Build 20250716)
- "映射表设定"对话框中添加"Tab提示背景色"设定按钮，点击后进入颜色选择窗口，可以对每个映射表映射开始或映射切换时候的提示信息背景色分别设置不同颜色。
- 对SendText文本发送功能进行问题修复。
- v1.3.8(Build 20250712)
- 添加"分类筛选"功能，点击"分类筛选"按钮显示映射表"分类"列，双击分类列单元格可以填写分类，右侧下拉列表中选择指定的分类标签可对映射表进行筛选显示。
- Tab标签页名称位置可以拖拽移动Tab映射表，添加Tab功能不再双击"+"Tab标签页，改为使用右上角"添加Tab"按钮，
- 移除程序主窗口右侧映射项上下移动按钮，移动映射项可以通过鼠标拖拽，选中后按键盘方向键"↑"和"↓"移动选中设定项。
- 选择一项或多项设定项后，按住L-Ctrl键再按键盘方向键"↑"和"↓"可将选中设定项直接移动到映射表顶部或底部。
- 升级程序zipupdater.exe更新，修复QKeyMapper进程退出速度慢时候更新复制程序文件出错的问题。
- 修复映射设定只有一个没有映射项的空白映射表时，修改映射表名称等映射表自定义数据无法正确保存的问题。
- v1.3.8(Build 20250708)
- "映射表自定义图片"设定区域增加"托盘图标像素"选择列表，如果选择的分辨率图层在ICO文件中存在的话，则使用ICO图片中的指定像素分辨率层来显示自定义托盘图标。否则与选择默认相同，由系统自动选择使用哪个分辨率层的图片显示托盘图标。
- 修复 v1.3.8.20250706 版本设置提示信息不显示时托盘图标未正确更新问题。
- v1.3.8(Build 20250706)
- "映射表设定"窗口添加以下"映射表自定义图片"设定功能：
- 点击"选择自定义图片"按钮，弹出对话框选择此Tab映射表的专用自定义图片(支持.ico/.png后缀)，如果图片文件可正确加载会现在在左侧图片框中并且更新到Tab名称标签的前面。
- 按下L-Ctrl键点击"选择自定义图片"按钮，会清除当前Tab的自定义图片。
- "显示位置"下拉列表可选择Tab自定义图片显示在提示信息文字的左侧、右侧或者不在提示信息上显示。
- "图片与文字间距"数值调整框可以增大提示信息显示自定义图片时图片与文字之间的间距大小 (默认间距0，间距范围0~1000)。
- "显示为图片图标"勾选框勾选时匹配映射配置成功启用此Tab映射表会使用此自定义图片作为系统托盘图标显示。
- 如果选择的自定义图片文件是在当前程序所在目录或子目录下会使用相对路径保存，当程序目录整体移动到其他PC上程序目录下的自定义图片仍然可以继续使用。
- "通用设定"标签页添加"提示高级设置"按钮，点击按钮弹出"提示信息高级设置"对话框，其中可以设置下面内容：
- 提示信息字体颜色 (按下L-Ctrl键点击颜色设置按钮恢复默认颜色)
- 提示信息字体大小 (默认大小16，大小范围1~72)
- 提示信息字体粗细 (默认粗体，可以选择细体、常规、粗体)
- 提示信息显示时长 (单位毫秒，默认3000毫秒，时长范围0~99999毫秒)
- 提示信息淡入动画时长 (单位毫秒，默认0毫秒:无淡入动画，时长范围0~99999毫秒)
- 提示信息淡出动画时长 (单位毫秒，默认500毫秒，时长范围0~99999毫秒)
- 提示信息背景框颜色 (可以设置背景框透明度，按下L-Ctrl键点击颜色设置按钮恢复默认颜色)
- 提示信息背景框圆角半径 (默认5像素点，范围0~1000，设置为0是直角边框)
- 提示信息背景框内边距 (默认15像素点，范围0~1000)
- 提示信息整体不透明度 (默认1.000，范围0.000~1.000，数值越小越透明)
- 提示信息水平方向偏移调整 (在提示信息位置选择基础上额外进行X水平方向偏移特定像素点，默认0，范围-5000~5000，负值向左偏移，正值向右偏移)
- 提示信息垂直方向偏移调整 (在提示信息位置选择基础上额外进行Y水平方向偏移特定像素点，默认0，范围-5000~5000，负值向上偏移，正值向下偏移)
- 如果在"映射表设定"窗口中设置了自定义"Tab提示字体颜色"，映射表Tab名称的字体颜色会与自定义设置的"Tab提示字体颜色"的保持一致。
- "映射表设定"窗口中按下L-Ctrl键点击"Tab提示字体颜色"按钮，会恢复未设定自定义"Tab提示字体颜色"的默认颜色。
- "映射项设定"窗口中添加与主窗口联动的"原始按键列表"和"映射按键列表"上方的分类选择按钮。
- 前台窗口监测同时使用事件监测和周期监测提高检测稳定性。
- 修复"映射按键列表"缺少Key2Mouse映射按键问题。
- "映射表设定"窗口添加以下"映射表自定义图片"设定功能：
- v1.3.8(Build 20250626)
- 主程序窗口的"原始按键列表"和"映射按键列表"上方加入分类选择按钮，分为"键盘按键"、"鼠标按键"、"手柄按键"、"功能按键"四个按钮，只有按钮按下状态列表中才会列出对应种类的按键名。
- "映射表设定"对话框中添加"Tab提示字体颜色"设定按钮，点击后进入颜色选择窗口，可以对每个映射表开始映射时候的提示字体分别设置不同颜色。
- "通用设定"标签页添加"选择托盘图标"按钮，点击按钮弹出的对话框窗口可以选择「空闲」、「监测中」、「全局映射」、「匹配映射」四种状态下的系统托盘图标，有多种颜色图标可以选择。【感谢用户Q群群友 汽波 制作的新系统托盘图标】
- "映射设定"标签页添加"进程图标作为托盘图标"勾选框，勾选时匹配映射配置成功会使用保存时记录的进程文件图标信息作为系统托盘图标显示。
- 前台窗口变化的监听方式优化，前台窗口切换时映射开始和停止的响应速度更快。
- 点击关闭按钮弹出对话框让用户选择是否勾选"点击关闭按钮将程序隐藏到系统托盘图标显示"，勾选后点击确定，之后点击关闭按钮软件都隐藏到系统托盘图标，不勾选点击确定，之后点击关闭按钮软件直接关闭软件。
【说明：对话框选择结果会保存到设定文件，按下L-Ctrl键点击关闭按钮会再次弹出对话框让用户重新选择。】 - "映射项设定"对话框的数值调整框获取焦点正在编辑中，如果关闭"映射项设定"对话框时会按照当前编辑中数据更新设定值。
- 对开始映射提示信息显示方式进行以下优化：
- "通用设定"标签页中添加映射状态提示信息大小设定数值框，默认大小16，数值范围1~72。
- 配置项开始映射的提...
Update to v1.3.7.20250622
[按键映射工具] [游戏工具] QKeyMapper
-
v1.3.7(Build 20250622)
- 修复 v1.3.7.20250618 新版本引入的手柄按键无法正常检测问题。(不再提供0618版本文件下载，可以升级到0622版本解决问题)
-
v1.3.7(Build 20250618)
- 映射按键列表添加"vJoy-LS-Radius"和"vJoy-RS-Radius"映射键，可配合"轻推值"设置滑动条添加例如"vJoy-LS-Radius[100]"、"vJoy-RS-Radius[150]"形式的左右虚拟摇杆半径切换映射键。摇杆半径设定范围：1~254
- 软件版本发布ZIP压缩包中添加了"映射表模版"文件夹，里面存放了一些可以直接导入的映射表模版用于参考，模版列表如下。
- PS手柄映射到键盘和鼠标.ini
- WASD按下轻推左摇杆双击重推左摇杆.ini
- Xbox手柄映射到键盘和鼠标.ini
- 左Ctrl和WASD组合键轻推左摇杆WASD按下重推左摇杆.ini
- 手柄右摇杆控制鼠标移动.ini
- 手柄左摇杆控制鼠标移动.ini
- 手柄陀螺仪控制鼠标移动.ini
- 虚拟游戏手柄左摇杆半径切换.ini
- 键盘WASD映射到键盘上下左右键.ini
- 键盘和鼠标映射到虚拟游戏手柄.ini
- 鼠标控制虚拟游戏手柄右摇杆.ini
- 鼠标控制虚拟游戏手柄左摇杆.ini
-
v1.3.7(Build 20250616)
- 添加"陀螺仪转鼠标"功能，如果物理游戏手柄支持标准陀螺仪协议(DS4、DS5等)，可以在原始按键列表中选择"Joy-Gyro2Mouse"使用陀螺仪转鼠标映射功能，通过沿某个轴转动手柄来控制鼠标指针水平和垂直方向移动。
- 新增"陀螺仪鼠标"设定标签页，其中的"水平速度"和"垂直速度"可以调整陀螺仪转鼠标的水平和垂直方向移动速度，数值范围0.00~99.99。
- 支持陀螺仪功能的游戏手柄连接到PC后，在游戏手柄列表中的手柄名称后面会显示[GyroEnabled]字样。列表中高亮选中手柄名称后按下"F2"键盘按键可以在陀螺仪启用和禁用之间进行切换。手柄连接时默认是启用状态。
- 映射按键列表添加"Gyro2Mouse-Hold"和"Gyro2Mouse-Move"映射键。"Gyro2Mouse-Hold"按下时抑制陀螺仪鼠标指针移动，松开时允许陀螺仪鼠标指针移动。"Gyro2Mouse-Move"按下时允许陀螺仪鼠标指针移动，松开时抑制陀螺仪鼠标指针移动。
- "陀螺仪鼠标"设定标签页中有其他高级设置选项，通常默认值可以正常使用。如果需要修改，建议详细了解设定值作用后再修改。
- 添加"陀螺仪转鼠标"功能，如果物理游戏手柄支持标准陀螺仪协议(DS4、DS5等)，可以在原始按键列表中选择"Joy-Gyro2Mouse"使用陀螺仪转鼠标映射功能，通过沿某个轴转动手柄来控制鼠标指针水平和垂直方向移动。
-
v1.3.7(Build 20250608)
- 窗口右上角关闭按钮改为隐藏窗口到系统托盘图标显示，最小化按钮改为最小化到任务栏显示。系统托盘图标上点击鼠标右键显示的菜单中选择"退出"，或者窗口显示时Alt+F4组合键可以关闭程序。
- "多输入设备"标签名更改为"多键鼠支持"，功能没有变化。
- 手柄摇杆或键盘按键控制鼠标指针移动的计算误差修正。
- 为"通用设定"、"映射设定"、"虚拟手柄"、"多键鼠支持"、"极限竞速" 标签页添加提示信息，鼠标指针移动到标签页名称位置会显示此标签页的提示信息。
- 游戏手柄检测SDL2库更新到SDL2-2.32.6(2025-05-05发布)，游戏手柄检测数据库SDL_GameControllerDB更新到20250523。
Update to v1.3.7.20250508
[按键映射工具] [游戏工具] QKeyMapper
v1.3.7(Build 20250508)
- 安装"多设备驱动"之前会弹出确认提示框提示用户需要详细阅读"多设备驱动"使用相关说明并谨慎使用，避免反复拔插输入设备或者反复休眠唤醒后出现的键盘/鼠标设备失效问题。
- 勾选"按键按下时循环"的按键序列，原始按键抬起时候立即打断当前正在发送的按键序列。
- 按键序列映射的原始按键重复按下时未正常打断前一次按键序列发送的问题修复。
v1.3.7(Build 20250412)
- 如果没有开启系统筛选键功能，程序启动时会弹出提示 "使用QKeyMapper强烈建议开启Windows系统的筛选键功能，避免出现各种异常问题。"
- Win10以上64位操作系统运行Qt5版本会弹出提示"Win10以上64位系统推荐使用Qt6_x64版本，Qt5版本仅用于兼容Win7操作系统。
v1.3.7(Build 20250226)
- 添加了两个映射按键 Crosshair-Normal 和 Crosshair-TypeA ，用于按下后在游戏中的画面上显示十字线准星。按下映射项设定窗口中 十字准星设定 按钮弹出的设定窗口可以调整颜色、线长、线宽、偏移量、透明度。
- README文件中更新 PS4-Dualshock手柄 按键对照表
- 物理游戏手柄按键检测数量增加到 Joy-Key30
- 语言切换时的翻译文本切换机制变更。
v1.3.7(Build 20250118)
- "虚拟游戏手柄"标签页的 X轴灵敏度 和 Y轴灵敏度，数值调整范围增大，从 1~1000 变为 1~50000 ，默认值从 80 变为 4000 。更新后虚拟手柄摇杆移动过慢可以在原来灵敏度设定值基础上乘以50倍，达到与原来相同效果。
- 修复更新模块导致内存泄漏问题。
v1.3.7(Build 20250115)
- 映射项设定窗口中添加 Post方式发送 勾选框，勾选后如果映射按键支持使用PostMessage方式发送(普通键盘和鼠标按键)，则使用Post方式发送映射键。
- 修复原始按键设置长按时间后，原始按键抬起时没正确释放的问题。
- 修复原始按键设置长按/双击，并且设定了"按键序列按下时循环"，按键序列执行完毕后没检查当前处于按下状态的长按和双击按键进行循环的问题。
v1.3.7(Build 20250110)
- "虚拟游戏手柄"标签页"回中延时"数值设置为0时，显示"不回中"，此时不会对鼠标控制虚拟手柄摇杆启动"回中延时"定时器。
- 移除 Mouse2vJoy-Direct 映射按键，在"虚拟游戏手柄"标签页中添加"直控模式"勾选框开关替代此映射键。
勾选此设定时，vJoy-Mouse2LS/vJoy-Mouse2RS 的鼠标控制虚拟手柄摇杆功能使用"直控模式"进行摇杆移动。
"回中延时"数值设置对"直控模式"的鼠标控制虚拟手柄摇杆同样生效。 - "虚拟游戏手柄"标签页的 X轴灵敏度 和 Y轴灵敏度 数值调整效果变更，从数值越小灵敏度越高修改为数值越大灵敏度越高，数值调整范围不变，仍然是1~1000，默认值从12变为80。
- 修复从 Gitee 网站进行更新时提示"找不到ZIP文件"错误。
v1.3.7(Build 20250108)
- "虚拟游戏手柄"标签页中添加"回中延时"数值调节框，可以设置1~1000毫秒之间的回中延迟时间，回中延时默认200毫秒。
v1.3.7(Build 20241230)
- 升级时选择[Yes]按钮自动升级覆盖当前版本文件后，如果升级文件解压并复制成功，会自动重新启动QKeyMapper程序。
- 映射表支持同时高亮选中多行内容，方法是鼠标左键点击选中一条后，按下键盘的 Shift 或 Ctrl 按键的同时鼠标左键选择另外一条映射表内容就可以进行连续多行内容的同时选中。下面是可以支持多行选中的操作：
- 按下 删除 按钮或者键盘 Delete 按键同时删除当前选中的多行内容。
- 按下 ▲ / ▼ 按钮或者键盘 ↑ / ↓ 按键同时向上或者向下移动当前选中的多行内容。
- 通过鼠标拖拽操作将当前选中的多行内容拖拽移动到指定位置。
- 选中当前映射表内容后按下 Ctrl + C 可以复制当前选中内容，之后切换到其他映射表按下 Ctrl + V 可以插入复制的内容：
- 如果复制内容没有与当前映射表中原始按键重复的条目，则复制内容全部插入到当前映射表，提示信息显示插入条目数量。
- 如果复制内容与当前映射表中部分原始按键重复，则插入不重复的复制内容到当前映射表，提示信息显示插入条目数量，以及由于重复无法插入的条目数量。
- 如果复制内容全部与当前映射表中已有原始按键重复，则不插入任何内容，显示失败提示。
- 执行插入操作时，会在当前映射表选中项的前面进行插入。如果当前映射表没有选中项，则插入复制内容到映射表末尾。
v1.3.7(Build 20241228)
- 添加 zipupdater.exe 升级程序，"检查更新"下载升级文件完成后可以选择对话框中的[Yes]来自动解压并覆盖现有程序文件。升级覆盖当前版本文件前会将当前 keymapdata_latest.ini 设定文件备份到 settings_backup 目录下。
- 为所有时间相关的数值调节框控件追加" 毫秒"单位显示后缀，包括："长按"和"双击"时间数值调节框、"延时"时间数值调节框、"连发按下"和"连发抬起"时间数值调节框。
- 停止映射状态下，鼠标左键点击映射表中项目高亮选中后，可以使用键盘"↑"和"↓"进行当前选中项上下移动，可以使用键盘"Del"按键删除当前选中项。
- "映射开启"、"映射关闭"、"显示切换"、"映射表切换"，以上快捷键如果设定的是组合键，会检测按键顺序，按键顺序一致才触发快捷键。
v1.3.7(Build 20241222)
- "检查更新"按钮前加入"更新网站"下拉列表，可以选择"Github"或"Gitee"两个不同的版本发布网站检查更新。切换后点击"保存设定"会将选择的网站保存到设定中。
注意: 某些网络环境需要梯子或魔法才能无障碍连接Github服务器。如果无法通过Github网站更新或下载更新速度过慢，请尝试选择Gitee网站进行更新。
v1.3.7(Build 20241220)
- "通用"标签页中添加"检查更新"按钮，检查Github上最新版本如果比当前运行版本新，则提示用户是否下载最新版本，点击"是"会下载zip升级压缩包到软件路径的"update_files"目录下，并在下载完成时显示提示对话框。
注意: 平时能够正常访问 Github 网络环境可使用，不能正常访问 Github 请使用其他途径更新。 - 按键映射"连发"和"原始按键穿透"同时启用时，原始按键穿透未生效问题修正。
Update to v1.3.7 Build 20241216
[按键映射工具] [游戏工具] QKeyMapper
v1.3.7(Build 20241216)
- 虚拟手柄摇杆多方向同时轻推问题修复。
v1.3.7(Build 20241210)
-
为特定虚拟手柄按键添加 “轻推值” 设置滑动条：
- 轻推值范围：1~254
- 默认值：255（滑动条在最大位置）
当滑动条值为 255 时，按键不会添加
[xxx]的后缀数字，与以前版本的按键按到底的最大值效果相同。轻推虚拟手柄按键格式示例：
vJoy-LS-Up[150] vJoy-Key12(RT)[100]支持的按键列表：
vJoy-Key11(LT) vJoy-Key12(RT) vJoy-LS-Up vJoy-LS-Down vJoy-LS-Left vJoy-LS-Right vJoy-RS-Up vJoy-RS-Down vJoy-RS-Left vJoy-RS-Right
Update to v1.3.7 Build 20241206
[按键映射工具] [游戏工具] QKeyMapper
v1.3.7(Build 20241206)
- 在"映射设定"标签页中添加"接受虚拟手柄输入"勾选框，勾选此设定时，映射后发送的虚拟手柄按键如果匹配到映射表中原始按键，也会触发并发送响应的映射按键。默认不勾选的情况下，QKeyMapper自己发送的任何虚拟手柄操作都不会检测触发原始按键。
- 修复几个"多输入设备"开启后的映射键发送问题。
v1.3.7(Build 20241130)
- 映射项设定窗口中添加"不可打断"勾选框，勾选后同一个原始按键的映射按键未发送完毕之前再次按下相同的原始按键不会进行任何动作。未勾选状态下默认重复按下相同原始按键会打断当前正在发送中的映射按键，重新开始发送映射按键。
- 映射项设定窗口中编辑映射按键时对重复的映射按键检查规则增加，同一映射按键使用不同的前后缀添加时也会检查为重复按键，例如："A+！A" 和 "A+A⏱200" 都会检查为存在重复按键。
v1.3.7(Build 20241126)
- 修复11月新版程序导入以前版本的mapdata INI文件崩溃问题。
v1.3.7(Build 20241124)
- 添加映射按键"Mouse-Move_WindowPoint"和"Mouse-Move_ScreenPoint"，可以指定将鼠标指针移动到窗口内或屏幕内的特定坐标点，坐标点设置方式与鼠标按键点击映射相同，L-Ctrl+鼠标左键选取全屏坐标点，L-Alt+鼠标左键在当前选定好的窗口标题对应窗口内选取坐标点。
- 映射项设定窗口中可以给(Mouse-L|R|M|X1|X2|Move_WindowPoint)和(Mouse-L|R|M|X1|X2|Move_ScreenPoint)这些鼠标坐标点映射加入":BG"，配合同时勾选"发送到同名窗口"勾选框，可以只发送PostMessage鼠标事件给指定标题的窗口，屏幕上鼠标指针位置不发生移动。
示例：PostMessage方式发送窗口内鼠标左键点击x坐标500，y坐标100位置 -> "Mouse-L:W:BG(500,100)"
示例：PostMessage方式发送屏幕内鼠标左键点击x坐标500，y坐标100位置 -> "Mouse-L:BG(500,100)" - 修复11月近期版本中引入的安装/卸载"ViGEm"驱动时程序界面卡死问题。
v1.3.7(Build 20241120)
- 映射项设定窗口中添加"检查组合键按下顺序"勾选框，勾选后如果原始按键是组合键则检查组合键触发时按键的按下顺序是否与原始按键排列顺序一致，一致时才触发组合键。例如："A+B"的原始按键组合键勾选"检查组合键按下顺序"后，先按下A再按下B才会触发组合键。"检查组合键按下顺序"默认值为启用，如果不希望检查组合键按下顺序则取消勾选。
v1.3.7(Build 20241116)
- 映射项设定窗口中添加"按键录制"按钮，按下此按钮弹出按键录制对话框。录制对话框下按下"F11"键开始进行按键录制，按下"F12"键停止按键录制，也可以鼠标左键点击"开始录制"/"停止录制"按钮来开始和停止按键录制。按键录制结束后的按键记录显示在编辑框中，并且自动复制到了剪贴板。之后可以直接将按键记录内容粘贴到"映射按键"编辑框等位置。
v1.3.7(Build 20241112)
- 映射项设定窗口中添加"发送时机"下拉选择列表，可以选择"正常/按下/抬起/按下+抬起/正常+抬起"，可以在不同的原始按键按下或释放时机发送映射按键。原有的"按键抬起时动作"勾选框被替代并移除。
- 映射项设定窗口中添加"抬起映射"编辑框，可以单独编译原始按键抬起时发送的映射按键，默认内容与"映射按键"相同。"映射按键"对应原始按键按下时发送的映射键，"抬起映射"对应原始按键抬起时发送的映射键。
- 映射项设定窗口中添加"映射按键解锁"勾选框，勾选"锁定"勾选框后可以追加勾选"映射按键解锁"勾选框。作用是短按映射按键中的任意按键可以解除锁定状态并释放当前锁定的按键。例如："L-Shift⏲500" 映射到 "L-Shift" 并勾选锁定，长按L-Shift后L-Shift会处于按下锁定状态，再次长按L-Shift解除锁定释放L-Shift键。如果同时勾选了"映射按键解锁"勾选框，长按L-Shift锁定后短按L-Shift键(映射按键)即可解除锁定释放L-Shift键。
- 扩展了映射项设定窗口中的"映射按键列表"添加"！"前缀的按键后覆盖功能，可以支持物理按键和映射后的虚拟按键(包括键盘按键和鼠标按键)。
v1.3.7(Build 20241030)
- 连发按键按下有可能导致程序崩溃问题修复。
- 停止映射状态下，映射软件主窗口前台显示时按下"L-Ctrl+S"执行"保存设定"动作。
- 其他影响使用体验的问题修复。
v1.3.7(Build 20241024)
- "按键序列按下保持"功能问题修复。
v1.3.7(Build 20241022)
- 添加映射按键"KeySequenceBreak"，用于打断"»"连接起来的按键序列发送。例如：设置原始按键Q，映射按键选择"KeySequenceBreak"，按下键盘按键Q时，会立即打断所有当前映射表中正在发送中的按键序列。
- 按键连发发送方式优化。
- 按键连发停止或者按键序列发送停止时检测当前仍然处于按下状态的物理按键并补发此物理按键的按下消息，使其仍然检测为按下状态。
- 添加"--scale="启动参数用于强制指定软件启动后的界面缩放比例，例如：快捷方式中设置 "QKeyMapper.exe --scale=1.0" 会强制以1.0缩放比例启动程序，不传递"--scale="参数时如果系统缩放比例为1.0会默认以1.25缩放比例启动。
v1.3.7(Build 20241012)
- 游戏手柄检测SDL2库更新到SDL2-2.30.8(2024-10-02发布)，游戏手柄检测数据库更新。
v1.3.7(Build 20241006)
- "映射表设定"对话框窗口添加"映射项描述"编辑框，可以对保存的某一条按键映射进行描述备注，备注信息在鼠标悬停在映射列表的原始按键格内会以提示框的形式悬浮显示在鼠标指针位置。
- 主窗口右上角添加"显示备注"可勾选按钮，默认"显示备注"按钮是未勾选抬起状态，原始按键列表不会在末尾追加备注信息显示。如果点击"显示备注"按钮会切换为勾选按下状态，此时映射表中原始按键会以"原始按键【映射项备注】"的形式显示。
- 映射按键发送并发处理方式优化。
v1.3.7(Build 20240928)
- 映射项设定窗口中添加"按键按下时循环"和"循环次数"勾选框，两个勾选框只能同时勾选其中一个，"按键按下时循环"用于原始按键持续按下状态循环重复发送按键序列，"循环次数"可以指定按下一次原始按键会循环重复发送多少次按键序列。
- 映射项设定窗口中的"映射按键列表"添加"！"前缀，此前缀添加在普通键盘或鼠标映射按键前面，用于实现按键后覆盖功能。例如："D"键映射到"！A"，先按下"A"键再按下"D"键会自动发送释放"A"键，"D"键抬起时如果"A"键物理按键仍然处于按下状态则会自动发送"A"键按下消息。(这个字符不是键盘上的叹号，需要使用映射项设定窗口的映射按键列表进行添加，或者从其他地方复制)
- 主窗口"保存设定"按钮下方添加了"映射设定描述"编辑框，可以对保存的进程和标题对应的设定进行描述备注，备注信息在设定选择列表中会以<process.exe|TitleX [映射设定描述]>"的形式显示。
- 语言选择下拉列表移动到"通用"设定标签页。
- 主窗口右上角添加"进程列表"可勾选按钮，默认"进程列表"按钮是勾选按下状态，会在主窗口左侧显示进程列表。如果点击"进程列表"按钮会切换为未勾选抬起状态，此时主窗口左侧进程列表隐藏，右侧映射表宽度变宽占据进程列表原来位置进行显示。
v1.3.7(Build 20240916)
- 单个设定选择项(进程名+标题)下支持添加多套映射表，默认的映射表标签名是"Tab1"，鼠标左键双击"+"标签页按钮添加一个空白映射表，标签页名称自动按照数字排序"Tab2"、"Tab3"……
- 鼠标左键双击已存在的映射表标签名位置进入"映射表设定"对话框，可以对"映射表名"和"映射表快捷键"进行修改，修改后需要点击"更新"按钮生效。更新后的"映射表名"和"映射表快捷键"需要点击"保存设定"按钮才会保存到设定文件中。
- "映射表快捷键"用于在游戏中映射生效状态下通过快捷键切换当前激活的映射表，这样游戏中可以随时切换几套不同按键映射。如果快捷键前面加入"$"字符，表示快捷键设置的按键键触发之后不会被拦截，仍然会发送给应用程序。
- "映射表设定"对话框窗口添加"导出映射表"按钮，可以导出某一个映射表中的全部按键映射数据到INI文件中，默认导出文件名是"mapdatatable.ini"，可在文件保存对话框中自己设置文件名。
- "映射表设定"对话框窗口添加"导入映射表"按钮，可以选择INI文件来导入之前导出的映射表数据文件，数据导入后追加到所选映射表的末尾。由于同一映射表中不能存在相同按键的重复映射，如果导入数据的原始按键与表中已存在数据的原始按键相同会被过滤掉。
- 物理手柄按键检测输入检测可以检测到虚拟手柄输入，可以将虚拟手柄按键映射和物理手柄按键映射组合来使用。例如：可以同时添加 vJoy-Mouse2RS 和 Joy-RS-Up、Joy-RS-Down、Joy-RS-Left、Joy-RS-Right 映射到键盘按键，达到鼠标向上下左右移动触发键盘按键的效果。
Update to v1.3.7 Build 20240812
[按键映射工具] [游戏工具] QKeyMapper
v1.3.7(Build 20240812)
- 原始按键列表中"Joy-"开头的物理手柄按键可以添加"@" + "0到9" 的数字编号来选择输入手柄的玩家编号(PlayerIndex)来进行区分映射，可支持0到9总共10个玩家编号。不添加"@" + "0到9" 的数字编号则映射来自所有物理手柄的输入。
- 添加"游戏手柄"下拉组合框用于配合"原始按键"列表选择原始按键映射的游戏手柄玩家编号(PlayerIndex)，根据所选择的游戏手柄玩家编号(PlayerIndex)在添加"Joy-"开头的原始按键映射时候在后面追加"@+数字编号0~9"，例如："Joy-Key1(A/×)@0"表示0号游戏手柄的(A/×)按键。
- 移除功能 [鼠标点击高亮选择一条映射表项目后，按下键盘"Backspace"键可以删除最后一个"»"或"+"连接的映射按键]，映射按键可以通过映射项设定窗口中的"映射按键"编辑框进行修改。
v1.3.7(Build 20240711)
- 映射列表中添加SendText映射，选择SendText后在"文本"单行编辑框中输入文字可以在按下原始按键时向当前前台窗口或指定窗口发送SendText()括号内的字符串。
- "显示切换键"和"映射开关键"设置按键字符串时可以在前面加入"$"字符，表示"显示切换键"和"映射开关键"设置的按键键触发之后不会被拦截，仍然会发送给应用程序。
- "通用"标签页中添加"提示信息"组合框，可以选择映射状态变化是否在屏幕上显示提示信息。提示信息显示位置可以选择"顶部左侧"、"顶部居中"、"顶部右侧"、"底部左侧"、"底部居中"、"底部右侧"。
- 修改为多个QKeyMapper程序可以同时在系统中运行，将QKeyMapper解压后的目录复制多份，可以为同时运行的多个程序设置各自独立的配置文件。
- "映射开关键"分离为"映射开启键"和"映射关闭键"，可以给开启和关闭设置不同的快捷键。
- 映射项设定窗口中的"映射按键列表"添加"↓"、"↑"、"⇵"前缀，这三种前缀可以添加在普通映射按键前面，用于映射按键按下的时机仅发送映射键的按下、抬起和同时发送按下+抬起。
v1.3.7(Build 20240622)
- 映射列表中添加"WindowPoint"映射,可以使用L-Alt+鼠标左键来标记当前映射设定对应窗口的窗口内相对坐标，选择Mouse-L|R|M|X1|X2_WindowPoint可以发送窗口内的相对鼠标坐标点击。"F8"按键显示当前设定映射窗口内的WindowPoint坐标点。窗口内坐标点颜色等其他规则与之前添加的"F9"按键显示的全屏坐标点相同。
- 在"映射设定"标签页中添加"发送到同名窗口"勾选框，勾选此设定时，映射按键会发送到与当前"标题"显示名称相同的所有窗口，即使窗口已最小化到任务栏未在前台显示。
v1.3.7(Build 20240610)
- 添加了设定"标签页"，将所有软件设定项分页归类到几个独立"标签页"中。标签页包括"通用"、"映射设定"、"虚拟游戏手柄"、"多输入设备"、"极限竞速"。
- 映射设定窗口中"原始按键"和"映射按键"编辑功能。
- 双击映射列表弹出的映射设定窗口中"原始按键"编辑框和"映射按键"编辑框中可以对原始按键和映射按键进行编译，编辑完成后按下编辑框尾部对应的"更新"按钮或者编辑框获取焦点状态按下键盘回车键(Enter)会更新"原始按键"或"映射按键"。更新成功时窗口中央显示绿色字体弹出消息"更新成功"，3秒后消失。更新失败窗口中央显示红色字体弹出消息提示更新失败原因，3秒后消失。
- 鼠标右键单击"原始按键列表"和"映射按键列表"可以将当前列表显示的内容根据当前光标位置添加到"原始按键"和"映射按键"编辑框中。
v1.3.7(Build 20240604)
- 鼠标左键双击映射列表中某一行在窗口中央弹出此按键的映射设定对话框，其中可以更改 "连发"、"锁定"、"按键抬起时动作"、"原始按键穿透"状态。
- 按键映射列表下方的 "连发按下"时间 和 "连发抬起"时间 数值调节框从主窗口移动到映射设定对话框中，每条按键映射的"连发按下"时间和"连发抬起"时间都可以单独进行设定和保存。
- 系统托盘图标添加右键菜单项"显示"/"隐藏"用于显示和隐藏主窗口，输入设备列表窗口显示中无效。
- 系统托盘图标添加右键菜单项"退出"，可以直接结束程序。
- 按键映射列表中的项增加拖拽功能。
- 按下"保存设定"按钮保存当前映射设定成功时，窗口中央显示绿色字体弹出消息"保存成功 : 设定项名称"，3秒时间逐渐淡出消失。
- 将"自动映射并最小化"勾选框设定拆分为 "自动匹配并启用映射" 和 "启动后自动最小化" 两个勾选框设定。
- 最后一次成功保存的设定文件会备份一份在QKeyMapper.exe相同路径下，文件名是"keymapdata_latest.ini"，如果遇到映射数据出错的问题，可以尝试用此文件替换"keymapdata.ini"进行恢复。
- 支持".exe"后缀以外的可执行文件进程名称。
- 映射设定对话框中添加 "按键序列按下保持" 勾选框，勾选状态下，原始按键按下不抬起时，按键序列的最后一组映射键(最后一个"»"之后的部分)保持按下状态。当原始按键抬起时发送按键序列的最后一组映射键的按键抬起。
