WinUI 3 1.5版本中软件键盘失效问题分析与修复

在Windows App SDK 1.5.0版本中，用户反馈了一个严重影响触摸交互体验的问题：当通过触摸方式选择文本框（TextBox）时，系统软件键盘无法正常弹出。这个问题不仅出现在基础文本框控件中，还影响了密码框（PasswordBox）、富文本框（RichTextBox）以及可编辑的下拉框（ComboBox）等所有基于文本输入的控件。

问题根源

经过微软开发团队的深入调查，发现该问题的本质是：

1. 在高DPI显示缩放比例（非100%缩放时）下，文本框的坐标位置计算出现偏差
2. 这种坐标偏差导致系统输入法框架无法正确识别当前获得焦点的文本框控件
3. 因此触屏输入时，系统误判没有需要文本输入的控件获得焦点，从而不触发软件键盘的显示

技术背景

在Windows系统中，软件键盘（触摸键盘）的触发机制依赖于：

• 输入控件必须正确报告其屏幕位置
• 系统需要准确知道当前获得焦点的输入区域
• 在高DPI环境下，所有坐标计算都需要考虑缩放因子

解决方案

微软团队在1.5.2版本中修复了这个问题，具体措施包括：

1. 修正了文本框在高DPI环境下的坐标计算逻辑
2. 确保输入法编辑器（IME）能正确获取控件位置信息
3. 统一了不同缩放比例下的位置报告机制

影响范围

该修复不仅解决了软件键盘不弹出的问题，还连带修复了：

• 输入法窗口位置错位的问题
• 触摸输入与键盘输入的焦点同步问题
• 高DPI环境下的文本选择体验

开发者建议

对于使用WinUI 3的开发人员：

1. 如果应用依赖触摸输入，建议尽快升级到1.5.2或更高版本
2. 在应用清单中明确声明输入类型需求
3. 测试时注意在不同DPI设置下的输入体验

这个案例再次证明了显示缩放处理在现代UI框架中的重要性，特别是在支持多种输入方式的跨设备应用中，准确的坐标计算是保证良好用户体验的基础。