Community Toolkit GridSplitter鼠标光标不切换问题

问题描述 #

使用WinUI Community Toolkit的GridSplitter控件时，点击拖拽可正常调整面板大小，但悬停在分割条上时鼠标光标不会切换为设置的样式。修改GripperCursor或CursorBehavior属性均无效果，光标始终保持默认样式。使用环境：

• WindowsAppSDK 1.3.2305
• CommunityToolkit.WinUI.UI 7.1.2
• CommunityToolkit.WinUI.UI.Controls.Layout 7.1.2

解决方案 #

1. 给GridSplitter设置透明背景 #

默认情况下，GridSplitter的Background属性为null，导致控件无法捕获鼠标悬停事件，光标切换逻辑无法触发。添加透明背景可解决此问题：

<controls:GridSplitter Grid.Row="1"
    GripperCursor="SizeNS"
    CursorBehavior="ChangeOnGripperHover"
    Background="Transparent" />

2. 升级Community Toolkit版本 #

7.1.2属于较早版本，存在WinUI3下的光标处理兼容问题。升级到最新稳定版（如8.2.0及以上），可修复此类已知bug。

3. 匹配正确的光标类型 #

针对垂直方向的GridSplitter（调整上下行高度），建议使用SizeNS光标（上下调整样式），而非UniversalNo（禁止操作样式），确保光标样式符合操作预期。

内容的提问来源于stack exchange，提问作者Jim D