WPF中Windows Narrator扫描模式下箭头键重复朗读控件问题求助

针对扫描模式下按上下箭头键时Narrator重复朗读控件内容的问题，提供以下几种可行方案：

方案1：自定义控件的自动化对等类 #

重写控件的自动化对等逻辑，限制朗读事件的触发频率，避免重复通知。以Button为例：

public class CustomButton : Button
{
    protected override AutomationPeer OnCreateAutomationPeer()
    {
        return new CustomButtonAutomationPeer(this);
    }
}

public class CustomButtonAutomationPeer : ButtonAutomationPeer
{
    private bool _hasAnnounced;

    public CustomButtonAutomationPeer(CustomButton owner) : base(owner) { }

    protected override void RaiseAutomationEvent(AutomationEvent eventId)
    {
        if (eventId == AutomationElementIdentifiers.AutomationFocusChangedEvent)
        {
            if (!_hasAnnounced)
            {
                base.RaiseAutomationEvent(eventId);
                _hasAnnounced = true;
                // 延迟重置标记，不影响正常导航流程
                Task.Delay(200).ContinueWith(_ => _hasAnnounced = false, TaskScheduler.FromCurrentSynchronizationContext());
            }
        }
        else
        {
            base.RaiseAutomationEvent(eventId);
        }
    }
}

之后在XAML中用CustomButton替换原生Button即可，Label控件可套用同样逻辑自定义。

方案2：拦截扫描模式下的键盘事件 #

在窗口或父控件的PreviewKeyDown事件中，判断是否处于Narrator扫描模式，手动控制朗读逻辑：

private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
{
    if (IsNarratorScanModeActive() && (e.Key == Key.Up || e.Key == Key.Down))
    {
        if (Keyboard.FocusedElement is UIElement focusedElement)
        {
            var peer = FrameworkElementAutomationPeer.FromElement(focusedElement);
            peer?.RaiseAutomationEvent(AutomationElementIdentifiers.NamePropertyChangedEvent);
            e.Handled = true;
        }
    }
}

private bool IsNarratorScanModeActive()
{
    // 需引用UIAutomationClient和UIAutomationTypes程序集
    var uiAutomation = new CUIAutomation();
    var narratorElement = uiAutomation.GetRootElement().FindFirst(
        TreeScope.Subtree,
        uiAutomation.CreatePropertyCondition(
            AutomationElementIdentifiers.NameProperty, "Narrator"));
    
    if (narratorElement == null) return false;
    
    // 实际需根据UIA文档获取扫描模式对应属性，此处为示例逻辑
    var scanMode = narratorElement.GetCurrentPropertyValue(
        AutomationElementIdentifiers.IsKeyboardFocusableProperty);
    return scanMode is bool mode && mode;
}

方案3：优化控件的自动化属性配置 #

避免嵌套控件导致的重复朗读源，确保AutomationProperties.Name唯一且无冗余：

错误示例（嵌套Label可能引发重复朗读）：

<Button AutomationProperties.Name="提交">
    <Label Content="提交"/>
</Button>

正确写法：

<Button Content="提交" AutomationProperties.Name="提交按钮"/>

直接用Button的Content作为显示内容，避免额外嵌套Label带来的自动化属性重复。

额外提示 #

• 确保使用最新版本的Windows Narrator，旧版本可能存在扫描模式原生Bug；
• 不要在控件的GotFocus事件中手动触发朗读，会与Narrator默认行为冲突。

内容的提问来源于stack exchange，提问作者Siva Sankara Naidu Bobba