obsidian/笔记文件/2.笔记/Qt QShortCut 快捷键 原理、实现和应用.md
2025-03-26 00:02:56 +08:00

2.0 KiB
Raw Permalink Blame History

#qt

应用

QShortCut方式的快捷键有好几种使用方式
1.通过绑定QAction或QMenu的方式。QAction和QMenu都提供了setShortcut()接口;
2.实例化一个对象:然后绑定信号槽activated()信号:

auto shortcut = new QShortcut(QKeySequence(tr("Ctrl+O", "File|Open")), parent); 
connect(shortcut,&QShortcut::activated ,this,[=](){});

原理 QShortCut通过一个全局shortcutmap进行管理当触发键盘事件时会先检查shortcutmap是否有对应快捷键然后触发快捷键绑定的事件再对键盘事件进行处理

匹配函数qWidgetShortcutContextMatcher(); 匹配函数过程: 1.首先是获取当前活动的顶部窗口qApp->activeWindow()与shorCut parent窗口所在的toplevelWindow所在窗口进行匹配排除是否在当前窗口触发 2.接着根据所设置的Qt::ShortcutContext来判断是以什么样的方式进行判断默认是Qt::WindowShortcut

底层实现,相关代码 qWidgetShortcutContextMatcher():是实际匹配快捷键的算法函数,通过函数回调方式解耦;

!Pasted image 20240806155009.png

!Pasted image 20240806155015.png

处理消息相关代码

!Pasted image 20240806155025.png

核心函数调用链:

tryShortcut() => nextState() => find() => dispatchEvent() 尝试调用快捷键 => 状态机查询匹配 => 查找快捷键 =>分发事件通过CoreApplication::sendEvent

注意事项 使用QShortCut方式需要注意的是如果采用动态嵌入窗口dock的方式组成你的界面两个界面尽量不要注册相同的快捷键不然会出现独立窗口时可用嵌入子窗口会出现快捷键冲突报错原因在于嵌入后QShortCut 通过全局shortcupMap判断的activeWindow是同一个顶部窗口 这时候倒不如直接通过keyEvent触发组合键盘事件即可。