WinUI 3 TextBox多行文本选择异常问题分析与解决方案

问题现象

在Windows App SDK 1.6.0版本的WinUI 3项目中，当TextBox控件包含多行文本时，用户进行文本选择操作会出现异常表现。具体表现为：

1. 从第二行开始选择文本后，选择区域无法正常取消
2. 在浅色模式下，重新选择其他文本时前景色会异常变回黑色

问题复现

该问题在以下环境可稳定复现：

• Windows 11 22H2及以上版本
• 使用WrapText或AcceptsReturn属性的TextBox控件
• 任何包含多行文本内容的场景

技术背景

TextBox控件是WinUI中最基础的文本输入控件之一，其选择功能依赖于Windows Composition API和DirectWrite文本渲染引擎。在多行文本场景下，选择逻辑需要正确处理：

• 行高计算
• 文本布局边界
• 视觉状态管理
• 选择区域的命中测试

根本原因

根据微软开发团队的确认，这是一个回归性问题(Regression)。问题出在文本选择状态的视觉管理逻辑中，当处理多行文本时：

1. 选择状态清除机制未能正确触发
2. 视觉状态树的更新存在时序问题
3. 前景色动画未正确处理多行场景

解决方案

微软团队已在内部修复该问题，并将包含在2025年1月的Windows App SDK 1.6服务更新中。开发者可通过以下方式应对：

临时解决方案

1. 对于单行文本场景，可设置AcceptsReturn="False"
2. 实现自定义选择视觉逻辑（需权衡维护成本）

推荐方案

等待官方补丁发布后升级至修复版本，这是最稳定可靠的解决方案。

影响范围

该问题影响所有基于WinUI 3 1.6.x版本开发的应用程序，特别是：

• 富文本编辑器
• 代码编辑器
• 多行文本输入表单
• 聊天应用的消息输入框

最佳实践

开发者在处理文本选择功能时应注意：

1. 充分测试多语言文本场景
2. 验证不同DPI缩放下的表现
3. 检查深色/浅色模式下的视觉一致性
4. 考虑触摸屏和键盘操作的不同交互方式

微软UI框架团队将持续改进TextBox控件的稳定性和兼容性，建议开发者关注后续版本更新。