如何正确处理TreeView内控件的键盘导航冲突问题？

针对TreeView节点里的ComboBox、TextBox会拦截↑/↓键，导致TreeView无法正常键盘导航的问题，提供三种实用解决方案：

方法1：TreeView级PreviewKeyDown事件拦截 #

直接在TreeView上注册PreviewKeyDown事件，检测到导航按键时标记事件已处理，并手动触发TreeView的导航逻辑，不让子控件抢着响应。

代码示例：

private void TreeView_PreviewKeyDown(object sender, KeyEventArgs e)
{
    var focusedElement = Keyboard.FocusedElement as FrameworkElement;
    // 判断焦点是否在TreeView的子控件内
    if (focusedElement?.IsDescendantOf(sender as TreeView) != true)
        return;

    if (e.Key is Key.Up or Key.Down)
    {
        e.Handled = true;
        var treeView = sender as TreeView;
        var currentItem = treeView.SelectedItem as TreeViewItem;
        if (currentItem == null) return;

        var parentItems = ItemsControl.ItemsControlFromItemContainer(currentItem);
        int currentIndex = parentItems.ItemContainerGenerator.IndexFromContainer(currentItem);
        TreeViewItem targetItem = null;

        if (e.Key == Key.Up && currentIndex > 0)
        {
            targetItem = parentItems.ItemContainerGenerator.ContainerFromIndex(currentIndex - 1) as TreeViewItem;
        }
        else if (e.Key == Key.Down && currentIndex < parentItems.Items.Count - 1)
        {
            targetItem = parentItems.ItemContainerGenerator.ContainerFromIndex(currentIndex + 1) as TreeViewItem;
        }

        if (targetItem != null)
        {
            treeView.SelectedItem = targetItem;
            targetItem.Focus();
        }
    }
}

方法2：自定义控件重写按键逻辑 #

创建自定义的ComboBox和TextBox，重写OnKeyDown方法，遇到↑/↓键时跳过自身处理，让事件冒泡到TreeView。

自定义ComboBox示例：

public class NavFriendlyComboBox : ComboBox
{
    protected override void OnKeyDown(KeyEventArgs e)
    {
        // 上下键交给TreeView处理，不执行自身的选项切换逻辑
        if (e.Key is Key.Up or Key.Down)
        {
            e.Handled = false;
            return;
        }
        base.OnKeyDown(e);
    }
}

自定义TextBox示例：

public class NavFriendlyTextBox : TextBox
{
    protected override void OnKeyDown(KeyEventArgs e)
    {
        // 拦截上下键，不让光标在文本内移动，交给TreeView导航
        if (e.Key is Key.Up or Key.Down)
        {
            e.Handled = false;
            return;
        }
        base.OnKeyDown(e);
    }
}

之后在DataTemplate里用这些自定义控件替换原生的ComboBox/TextBox即可。

方法3：附加属性统一管控 #

通过附加属性实现全局开关，给TreeView添加上该属性后，自动拦截子控件的导航按键，不用逐个修改控件或事件。

附加属性代码：

public static class TreeViewNavHelper
{
    public static readonly DependencyProperty EnableNavKeyInterceptionProperty =
        DependencyProperty.RegisterAttached(
            "EnableNavKeyInterception",
            typeof(bool),
            typeof(TreeViewNavHelper),
            new PropertyMetadata(false, OnEnableChanged));

    public static void SetEnableNavKeyInterception(DependencyObject obj, bool value)
        => obj.SetValue(EnableNavKeyInterceptionProperty, value);

    public static bool GetEnableNavKeyInterception(DependencyObject obj)
        => (bool)obj.GetValue(EnableNavKeyInterceptionProperty);

    private static void OnEnableChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not TreeView treeView) return;

        if ((bool)e.NewValue)
            treeView.PreviewKeyDown += OnTreeViewPreviewKeyDown;
        else
            treeView.PreviewKeyDown -= OnTreeViewPreviewKeyDown;
    }

    private static void OnTreeViewPreviewKeyDown(object sender, KeyEventArgs e)
    {
        if (e.Key is not (Key.Up or Key.Down)) return;
        if (Keyboard.FocusedElement is not (ComboBox or TextBox)) return;

        e.Handled = true;
        var treeView = sender as TreeView;
        var currentContainer = treeView.ItemContainerGenerator.ContainerFromItem(treeView.SelectedItem) as TreeViewItem;
        if (currentContainer == null) return;

        var parentItems = ItemsControl.ItemsControlFromItemContainer(currentContainer);
        int currentIndex = parentItems.ItemContainerGenerator.IndexFromContainer(currentContainer);
        TreeViewItem targetItem = null;

        if (e.Key == Key.Up && currentIndex > 0)
            targetItem = parentItems.ItemContainerGenerator.ContainerFromIndex(currentIndex - 1) as TreeViewItem;
        else if (e.Key == Key.Down && currentIndex < parentItems.Items.Count - 1)
            targetItem = parentItems.ItemContainerGenerator.ContainerFromIndex(currentIndex + 1) as TreeViewItem;

        if (targetItem != null)
        {
            treeView.SelectedItem = targetItem.DataContext;
            targetItem.Focus();
        }
    }
}

XAML中使用方式：

<TreeView local:TreeViewNavHelper.EnableNavKeyInterception="True">
    <!-- TreeView内容定义 -->
</TreeView>

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