WPF中如何让ListBox的ScrollViewer每次加载时自动滚动到顶部

出现该问题的核心原因是ListBox默认会自动将选中项滚动到可视区域，加载时如果存在已选中的项，内置ScrollViewer会自动触发滚动定位，以下是不同场景下的解决方法：

方法1：加载完成后手动滚动到顶部 #

通过监听ListBox的加载完成事件，手动触发ScrollViewer滚动到顶部，是兼容性最高的通用方案：

• 首先在XAML中给ListBox注册Loaded事件

<ListBox x:Name="ImageListBox" Loaded="ImageListBox_Loaded">
    <!-- 你的图片项模板代码 -->
</ListBox>

• 后台添加事件逻辑和可视化树获取辅助方法

private void ImageListBox_Loaded(object sender, RoutedEventArgs e)
{
    // 可选：不需要保留上次选中状态时添加该行，需要保留则删除
    ImageListBox.SelectedIndex = -1;
    
    // 获取ListBox内置的ScrollViewer
    var scrollViewer = GetVisualChild<ScrollViewer>(ImageListBox);
    scrollViewer?.ScrollToTop();
}

// 可视化树子元素获取辅助方法
private static T GetVisualChild<T>(DependencyObject parent) where T : DependencyObject
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        var child = VisualTreeHelper.GetChild(parent, i);
        if (child is T typedChild)
            return typedChild;
        var result = GetVisualChild<T>(child);
        if (result != null)
            return result;
    }
    return null;
}

方法2：禁用选中项自动定位行为（更彻底） #

WPF 4.5及以上版本可以直接通过修改项容器样式，关闭选中项自动滚动到可视区域的默认逻辑：

<ListBox x:Name="ImageListBox">
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem">
            <Setter Property="BringIntoViewOnFocusChange" Value="False"/>
        </Style>
    </ListBox.ItemContainerStyle>
    <!-- 你的图片项模板代码 -->
</ListBox>

该方法不会影响手动滚动操作，仅禁用选中项变化时的自动滚动，如果需要默认滚动到顶部，可搭配方法1的Loaded事件逻辑使用。

方法3：MVVM场景下的附加属性复用方案 #

如果不想写后台事件代码，可以封装附加属性实现跨页面复用：

public static class ListBoxExtensions
{
    public static readonly DependencyProperty ScrollToTopOnLoadProperty = DependencyProperty.RegisterAttached(
        "ScrollToTopOnLoad", typeof(bool), typeof(ListBoxExtensions), new PropertyMetadata(false, OnScrollToTopOnLoadChanged));

    private static void OnScrollToTopOnLoadChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not ListBox listBox) return;
        if ((bool)e.NewValue)
        {
            listBox.Loaded += (s, _) =>
            {
                var scrollViewer = GetVisualChild<ScrollViewer>(listBox);
                scrollViewer?.ScrollToTop();
            };
        }
    }

    public static void SetScrollToTopOnLoad(DependencyObject element, bool value)
    {
        element.SetValue(ScrollToTopOnLoadProperty, value);
    }

    public static bool GetScrollToTopOnLoad(DependencyObject element)
    {
        return (bool)element.GetValue(ScrollToTopOnLoadProperty);
    }

    private static T GetVisualChild<T>(DependencyObject parent) where T : DependencyObject
    {
        for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
        {
            var child = VisualTreeHelper.GetChild(parent, i);
            if (child is T typedChild)
                return typedChild;
            var result = GetVisualChild<T>(child);
            if (result != null)
                return result;
        }
        return null;
    }
}

封装完成后直接在XAML中调用即可：

<ListBox local:ListBoxExtensions.ScrollToTopOnLoad="True">
    <!-- 你的图片项模板代码 -->
</ListBox>

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