WinUI 3自定义控件视觉状态不生效问题求助

以下是针对你遇到的CaptionText未显示问题的具体排查方向和解决方法：

1. 检查控件模板中CaptionText的基础定义 #

• 确认Generic.xaml里的控件模板中，CaptionText控件（如TextBlock/ContentPresenter）的Visibility属性未被默认设置为Collapsed，确保其处于Visible状态。
• 验证布局容器结构：如果使用Grid等布局控件，需为CaptionText分配对应的行/列，避免被嵌套的TextBox遮挡或未被布局渲染。
• 检查绑定语法：确认CaptionText的Text属性绑定路径正确，例如绑定控件自身的依赖属性时，需使用{Binding RelativeSource={RelativeSource TemplatedParent}, Path=对应属性名}，避免因绑定目标错误导致内容为空。

2. 视觉状态切换逻辑验证 #

• 检查VisualStateGroup的定义：确保Unvalidated、Passed、Error三个视觉状态属于同一个VisualStateGroup，状态切换时才能正确触发对应变更。
• 核对视觉状态内的操作：确认每个状态中对CaptionText的Text属性赋值或绑定正确，例如Error状态下是否正确绑定到ErrorCaption依赖属性，且未错误设置Visibility为Collapsed。
• 验证状态触发逻辑：在依赖属性（HasError/HasPassed/IsUnvalidated）的PropertyChangedCallback方法中，确认已正确调用VisualStateManager.GoToState(this, 目标状态名, true)，且状态名称与Generic.xaml中定义的一致。

3. 依赖属性注册正确性检查 #

• 确认Caption相关依赖属性（如ErrorCaption、PassedCaption、DefaultCaption）已正确注册，元数据中未遗漏必要设置，例如属性变更时是否需要通知UI更新。
• 检查状态类依赖属性（HasError等）的回调逻辑：确保在属性值变更时，能正确判断当前应切换到哪个视觉状态，没有逻辑分支错误导致状态未触发。

4. 调试工具辅助排查 #

• 使用Visual Studio的Live Visual Tree查看控件可视化结构，确认CaptionText控件是否存在，查看其Visibility、Text属性的实际值，以及绑定是否存在错误（可在Live Property Explorer中查看绑定状态）。
• 在依赖属性的PropertyChangedCallback中添加断点，确认状态切换代码是否被执行，传入的状态名称是否符合预期。
• 手动调用VisualStateManager.GoToState方法，直接切换到某一状态，测试CaptionText是否能正常显示，排除状态切换逻辑以外的问题。

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