如何让Narrator（讲述人）读取WPF Popup控件内的文本内容

核心原因 #

WPF的Popup控件默认不会被系统UI自动化框架识别为新的激活内容区域，打开时不会自动触发焦点转移和内容变更通知，因此讲述人无法感知到弹窗内容的存在。

具体修复步骤 #

• 步骤1：给Popup根节点添加 accessibility 基础配置
  修改你的Popup XAML定义，补充以下属性即可，原有配置保持不变：

<Popup x:Class="ClassApp.UserInterface.Views.Windows.Settings.MeetingDetailsPopup"
       ... 
       Focusable="True"
       AutomationProperties.Name="会议详情弹窗"
       AutomationProperties.LiveSetting="Assertive">

LiveSetting设为Assertive会让讲述人优先朗读弹窗内的新内容，不会被其他背景内容打断。

• 步骤2：绑定Popup的Opened事件，手动触发焦点和自动化通知
  在Popup的后台代码中添加Opened事件处理逻辑：

public MeetingDetailsPopup()
{
    InitializeComponent();
    Opened += MeetingDetailsPopup_Opened;
}

private void MeetingDetailsPopup_Opened(object sender, EventArgs e)
{
    // 将焦点转移到弹窗内第一个可交互元素，此处示例为弹窗右上角的关闭按钮
    CloseButton.Focus();
    // 通知UI自动化框架有新内容加载、焦点变更，触发讲述人主动朗读
    var automationPeer = FrameworkElementAutomationPeer.FromElement(this) 
        ?? new FrameworkElementAutomationPeer(this);
    automationPeer.RaiseAutomationEvent(AutomationEvents.AsyncContentLoaded);
    automationPeer.RaiseAutomationEvent(AutomationEvents.AutomationFocusChanged);
}

• 步骤3：补充非交互元素的识别配置（可选）
  如果你需要让不可聚焦的静态TextBlock也能被自动朗读，可以给对应TextBlock补充Focusable="True"属性，也可以在打开弹窗时遍历内容按顺序触发朗读。

验证点 #

确认你现有的AutomationProperties.Name、AutomationProperties.LabeledBy配置没有绑定为空的情况，所有按钮、文本的辅助属性值都正确即可。

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