5.0 KiB
5.0 KiB
2026-04-29 BarcodeEditor 虚拟键盘不可点击问题修复日志
一、问题背景
在 BarcodeEditor 中，lineEditContent 获取焦点后会正常呼出 InputMethod 虚拟键盘，但键盘弹出后，任意按键都无法点击。
用户反馈该问题只出现在 BarcodeEditor 场景中，而 InputMethod 在系统其他页面表现正常。
二、问题现象
lineEditContent获得焦点后，虚拟键盘可以显示。- 虚拟键盘显示后，按钮点击无响应。
- 同一套输入法在其他页面可以正常输入，说明不是键盘控件本身整体失效。
三、排查思路
本次排查没有只局限在 BarcodeEditor 单页，而是沿着“焦点切换 + 全局事件过滤 + 输入法显示/隐藏逻辑”做了整体梳理：
- 检查
BarcodeEditor.cpp / .h中与编辑框及焦点处理相关的逻辑。 - 检查
InputMethod.cpp与MyInputMethod.cpp中虚拟键盘显示、隐藏、发送按键的实现。 - 检查全局输入法触发入口，最终定位到
InkJetPrinter::eventFilter(QObject *, QEvent *)。
排查后确认：
- 当前工程通过
InkJetPrinter::eventFilter()统一处理FocusIn / FocusOut，从而控制虚拟键盘显示与隐藏。 - 若事件处理不区分“点到了输入法自己”还是“点到了其他区域”，就可能出现键盘刚收到点击就被焦点切换或隐藏逻辑打断的问题。
- 因为工程里已经有全局事件过滤，所以比起只在
BarcodeEditor中单点修复，更适合补齐一套通用的“点击空白处失焦并隐藏键盘，同时点击键盘自身不误隐藏”的机制。
四、本次修改内容
1. 修改 MyInputMethod.cpp
新增头文件：
#include <QTextEdit>
新增方法：
bool MyInputMethod::shouldIgnoreHideForWidget(QWidget *widget) const
作用：
- 判断当前点击/聚焦的控件是否属于虚拟键盘本体；
- 如果是
inputMethod自身、其子控件，或digitalInput自身、其子控件，则返回true； - 同时保留对
inputPreviewBox的排除。
这样做的目的，是避免“用户点击虚拟键盘按钮时，程序先把键盘隐藏掉，导致按钮无法真正处理点击”。
void MyInputMethod::clearCurrentFocusAndHide()
作用：
- 获取当前焦点控件；
- 如果当前焦点不是输入法本体，则清除其焦点；
- 隐藏
inputMethod和digitalInput； - 调用
inputMethod->onHiden()做隐藏后的清理。
这个方法用于统一处理“点击空白区域时关闭输入法”的需求。
调整 updateHandler(int type)
在入口增加：
- 如果当前焦点控件属于输入法自己，则直接返回，不再继续执行隐藏/显示逻辑。
这一步用于避免输入法自身参与焦点切换时，触发错误的隐藏处理。
2. 修改 InkJetPrinter.cpp
修改 InkJetPrinter::eventFilter(QObject *watched, QEvent *event)：
- 保留原有
FocusIn / FocusOut对输入法的显示隐藏控制； - 新增
QEvent::MouseButtonPress处理。
新增逻辑如下：
- 若当前被点击对象是
QWidget； - 且它不是
QSpinBox / QLineEdit / QTextEdit这类可编辑输入控件； - 且它也不是虚拟键盘本身及其子控件；
- 则调用
myInputMethod->clearCurrentFocusAndHide()。
也就是说：
- 点击输入框：正常保留焦点，键盘继续可用；
- 点击虚拟键盘按钮：不会被误判为“点击空白处”，键盘不会先被隐藏；
- 点击普通空白区域或非编辑控件：输入框失焦，键盘自动收起。
五、修复结果
本次修复后，输入法相关行为被整理为一套更稳定的通用机制：
- 可编辑控件获取焦点时，正常弹出虚拟键盘；
- 点击虚拟键盘自身时，不会触发误隐藏；
- 点击页面空白区域或普通控件时，会清理当前焦点并隐藏虚拟键盘。
这次处理不是“只为 BarcodeEditor 打补丁”，而是将该问题在全局输入法交互层做了统一修复，可同时改善其他页面的体验一致性。
六、验证建议
建议至少验证以下场景：
BarcodeEditor
- 点击
lineEditContent，确认虚拟键盘正常弹出； - 连续点击虚拟键盘字母、数字、退格、确认等按键，确认可以响应；
- 点击页面空白区域，确认输入框失焦且键盘隐藏。
其他页面回归验证
- 任意
QLineEdit页面：确认键盘仍可正常呼出和输入； QSpinBox页面：确认数字键盘逻辑未受影响；QTextEdit页面：确认点击输入法按钮仍可输入文本；- 点击输入法自身按钮时，不应出现“按下立即消失”或“完全点不动”的现象。
七、本次会话记录补充
在本次对话过程中，除修复“BarcodeEditor 弹出键盘但无法点击”问题外，还顺带完成了一项通用交互增强：
- 点击空白区域自动失焦并隐藏虚拟键盘。
该增强已通过全局事件过滤接入，而不是局限于某一个编辑器页面，便于后续维护。