WPF编程式设置按钮焦点时不显示自定义焦点样式的问题

问题原因 #

WPF的FocusVisualStyle是专门为键盘导航场景设计的视觉装饰器，只有当控件通过键盘操作（如Tab键、箭头键）获得焦点（对应FocusState.Keyboard）时，才会自动显示该样式。而通过代码调用firstButton.Focus()时，默认设置的是程序式焦点（FocusState.Programmatic），这种焦点获取方式不会触发FocusVisualStyle的显示逻辑，因此按钮虽然已获得逻辑焦点，但看不到黑色边框。

解决方法 #

方法1：强制设置键盘焦点（改动最小） #

直接使用Keyboard.Focus()方法为按钮设置键盘焦点，触发FocusVisualStyle的显示逻辑。注意需确保窗口已激活：

Activate();
// 替换原有的firstButton.Focus()
Keyboard.Focus(firstButton);

方法2：自定义按钮模板（更灵活） #

放弃依赖FocusVisualStyle，直接在按钮的控件模板中通过IsFocused触发器控制焦点边框，无论通过哪种方式获取焦点都会显示样式：

1. 修改窗口资源中的按钮样式：

<Window.Resources>
    <Style x:Key="CustomButtonStyle" TargetType="Button">
        <Setter Property="Background" Value="Transparent"/>
        <Setter Property="BorderBrush" Value="Transparent"/>
        <Setter Property="BorderThickness" Value="0"/>
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="Button">
                    <Border x:Name="RootBorder"
                            Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}">
                        <ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center"/>
                    </Border>
                    <ControlTemplate.Triggers>
                        <!-- 焦点状态触发边框显示 -->
                        <Trigger Property="IsFocused" Value="True">
                            <Setter TargetName="RootBorder" Property="BorderBrush" Value="Black"/>
                            <Setter TargetName="RootBorder" Property="BorderThickness" Value="2"/>
                        </Trigger>
                    </ControlTemplate.Triggers>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</Window.Resources>

2. 创建按钮时应用该样式（无需再设置FocusVisualStyle）：

var button = new Button()
{
    Name = $"btn{_nextButtonId++}",
    Content = "some text on the button",
    Style = (Style)FindResource("CustomButtonStyle"),
    Tag = "something"
};
button.Click += Button_Click;
pnl.Children.Add(button);

内容的提问来源于stack exchange，提问作者ivan.ukr