为何自定义WPF UserControl自动成为FocusScope？

我有一个基于TargetFramework = net6.0-windows10.0.17763.0的WPF桌面应用。根据微软文档说明：

在可扩展应用标记语言(XAML)中，可通过将FocusManager附加属性IsFocusScope设置为true，将元素转换为焦点范围；在代码中，可通过调用SetIsFocusScope方法实现。
...
WPF中默认作为焦点范围的类包括Window、MenuItem、ToolBar和ContextMenu。

我的窗口包含一些控件，出现了意外的焦点行为。为排查问题，我在XAML中添加了以下代码：

<TextBox GotFocus="UIElement_OnGotFocus" />

并在代码后置中添加：

private void UIElement_OnGotFocus(object sender, RoutedEventArgs e)
{
    var c = (Control)sender;
    var fs = (Control)FocusManager.GetFocusScope(c);
    Console.WriteLine(fs);
}

运行后日志输出的焦点范围居然是MyControls.CustomView——这是一个直接继承自UserControl的自定义控件。但我可以确定：代码库中从未手动设置IsFocusScope属性或调用SetIsFocusScope方法，且该自定义控件也不属于微软文档中提到的四个默认焦点范围类。

原因分析 #

WPF并不会默认将UserControl标记为焦点范围，但存在几种容易被忽略的触发场景：

• 控件模板/样式的隐性设置：检查自定义控件的ControlTemplate或应用在它身上的样式，是否在模板根元素中设置了FocusManager.IsFocusScope="True"。模板中的父元素若被设置该属性，会导致整个控件成为焦点范围。
• XAML层级中的间接关联：FocusManager.GetFocusScope(c)会返回目标元素最近的焦点范围上级元素。如果测试用的TextBox位于CustomView内部，返回结果为CustomView，说明该控件自身或其直接父容器被设置了焦点范围。
• 第三方依赖的暗中修改：如果CustomView引用了第三方控件库，或继承了带有焦点范围设置的基类，第三方代码可能通过附加属性或逻辑偷偷设置了IsFocusScope。
• 边缘场景的内部处理：在部分罕见场景下，比如UserControl作为对话框内容、Frame导航页面时，WPF可能自动处理焦点范围，但这类情况有明确触发条件。

验证方法 #

你可以直接检查CustomView的IsFocusScope值，确认是否被设置为true：

bool isFocusScope = FocusManager.GetIsFocusScope(yourCustomViewInstance);
Console.WriteLine($"CustomView IsFocusScope: {isFocusScope}");

若结果为true，可通过Visual Studio的Live Visual Tree工具查看该控件的属性，追踪IsFocusScope的来源（本地设置/样式继承/模板绑定）。

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