如何让ListBox的ItemTemplate中的Button接收键盘事件？

我遇到过完全一样的场景——用Button作为ListBoxItem模板的根元素时，鼠标点击正常触发命令，但通过键盘导航到列表项后按Enter/Space键却毫无反应，根源就是此时键盘焦点在ListBoxItem而非内部的Button上。而且和你一样，我也不想手动维护所有Button的激活按键组合，毕竟WPF已经内置了这些逻辑，我们只需要让ListBoxItem把键盘事件转发给内部的Button就行。

先回顾一下你的ItemTemplate：

<DataTemplate x:Key="myDataTemplate">
    <Button Command="{Binding MyListItemButtonCommand}" CommandParameter="{Binding .}">
        <!-- 细节省略 -->
    </Button>
</DataTemplate>

核心思路 #

我们的目标是：当ListBoxItem通过键盘获得焦点时，让内部的Button自动接管键盘事件，利用WPF原生Button的按键处理逻辑（比如Enter/Space触发Command），不需要写任何硬编码的按键判断。

方案1：通过ItemContainerStyle实现焦点转发 #

这是最简单的实现方式，只需要给ListBox的ItemContainerStyle添加一个触发器，当ListBoxItem获得键盘焦点时，把逻辑焦点设置到内部的Button上：

<ListBox ItemTemplate="{StaticResource myDataTemplate}">
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Style.Triggers>
                <!-- 当ListBoxItem获得键盘焦点时，让内部Button成为聚焦元素 -->
                <Trigger Property="IsKeyboardFocused" Value="True">
                    <Setter Property="FocusManager.FocusedElement" 
                            Value="{Binding RelativeSource={RelativeSource Self}, Path=Content}" />
                </Trigger>
            </Style.Triggers>
            <!-- 可选：保留ListBoxItem的默认焦点视觉样式，避免失去导航反馈 -->
            <Setter Property="FocusVisualStyle" Value="{StaticResource {x:Static SystemParameters.FocusVisualStyleKey}}" />
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

这里Path=Content对应的就是ItemTemplate里的Button（因为ItemTemplate的根元素会作为ListBoxItem的Content），这样一来，ListBoxItem获焦后，Button会自动处理所有原生按键逻辑，完全符合你的需求。

方案2：重写ListBoxItem模板（更精细控制） #

如果你需要自定义ListBoxItem的视觉状态，同时保证焦点转发，可以重写它的ControlTemplate：

<ListBox ItemTemplate="{StaticResource myDataTemplate}">
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Setter Property="Template">
                <Setter.Value>
                    <ControlTemplate TargetType="ListBoxItem">
                        <Border x:Name="Bd" 
                                Background="{TemplateBinding Background}"
                                BorderBrush="{TemplateBinding BorderBrush}"
                                BorderThickness="{TemplateBinding BorderThickness}"
                                Padding="{TemplateBinding Padding}"
                                SnapsToDevicePixels="True">
                            <ContentPresenter x:Name="ContentPresenter"
                                              Content="{TemplateBinding Content}"
                                              ContentTemplate="{TemplateBinding ContentTemplate}"
                                              KeyboardNavigation.IsTabStop="False"
                                              KeyboardNavigation.TabNavigation="None"/>
                        </Border>
                        <ControlTemplate.Triggers>
                            <Trigger Property="IsKeyboardFocused" Value="True">
                                <Setter TargetName="ContentPresenter" 
                                        Property="FocusManager.FocusedElement"
                                        Value="{Binding ElementName=ContentPresenter, Path=Content}" />
                            </Trigger>
                            <!-- 保留ListBoxItem的选中、悬停等原生状态样式 -->
                            <Trigger Property="IsSelected" Value="True">
                                <Setter TargetName="Bd" Property="Background" Value="{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" />
                                <Setter Property="Foreground" Value="{DynamicResource {x:Static SystemColors.HighlightTextBrushKey}}" />
                            </Trigger>
                            <Trigger Property="IsEnabled" Value="False">
                                <Setter Property="Foreground" Value="{DynamicResource {x:Static SystemColors.GrayTextBrushKey}}" />
                            </Trigger>
                        </ControlTemplate.Triggers>
                    </ControlTemplate>
                </Setter.Value>
            </Setter>
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

这个方案不仅实现了焦点转发，还能让你自由定制ListBoxItem的外观，同时不破坏原生的按键处理逻辑。

方案3：简洁的KeyboardNavigation配置 #

如果你追求极简代码，可以结合KeyboardNavigation属性和FocusManager，让ListBoxItem的焦点自动传递给Button：

<ListBox ItemTemplate="{StaticResource myDataTemplate}">
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Setter Property="KeyboardNavigation.TabNavigation" Value="Local" />
            <Setter Property="FocusManager.FocusedElement" 
                    Value="{Binding RelativeSource={RelativeSource Self}, Path=Content}" />
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

所有这些方案都不需要你手动处理任何按键事件，完全复用WPF内置的Button按键响应逻辑，完美解决了键盘导航时无法触发命令的问题。

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