如何将WPF ScrollViewer垂直偏移量定位到指定Item位置

要让指定Item滚动到ScrollViewer顶部（非末尾Item时），可以按以下步骤实现：

核心逻辑 #

先定位目标Item对应的可视化容器，计算它相对于ScrollViewer的垂直位置，再设置滚动偏移量，同时处理末尾Item的边界情况，避免出现底部空白。

步骤1：获取目标Item的容器控件 #

通过ItemsControl的ItemContainerGenerator获取指定索引的容器，需确保容器已生成（若ItemsControl开启虚拟化，需先触发Item加载）：

// itemsControl为你的ItemsControl实例，targetIndex是要定位的Item索引
var targetContainer = itemsControl.ItemContainerGenerator.ContainerFromIndex(targetIndex) as FrameworkElement;
if (targetContainer == null)
{
    // 容器未生成时，先更新布局尝试获取
    itemsControl.UpdateLayout();
    targetContainer = itemsControl.ItemContainerGenerator.ContainerFromIndex(targetIndex) as FrameworkElement;
}

步骤2：计算容器相对于ScrollViewer的垂直偏移 #

用坐标转换方法获取容器在ScrollViewer内的顶部位置：

if (targetContainer != null && scrollViewer != null)
{
    var transform = targetContainer.TransformToAncestor(scrollViewer);
    var position = transform.TransformPoint(new Point(0, 0));
    double targetOffset = position.Y;

步骤3：设置滚动偏移并处理边界 #

根据Item位置和ScrollViewer参数计算最终偏移，确保非末尾Item停在顶部，末尾Item不超出最大滚动范围：

double viewportHeight = scrollViewer.ViewportHeight;
    double maxScrollOffset = scrollViewer.ScrollableHeight;

    double finalOffset = targetOffset;
    // 判断是否为末尾Item，或目标位置+视口高度超出最大偏移
    if (targetIndex + 1 >= itemsControl.Items.Count || targetOffset + viewportHeight > maxScrollOffset)
    {
        finalOffset = maxScrollOffset;
    }

    // 执行滚动
    scrollViewer.ScrollToVerticalOffset(finalOffset);
}

MVVM场景适配 #

如果要通过ViewModel控制滚动（比如你用了自定义ScrollOffset附加属性），可以在ViewModel中添加命令，在View的代码后台绑定执行上述逻辑：

// 示例：ViewModel中定义命令
public ICommand ScrollToItemCommand { get; set; }

// View构造函数中绑定
viewModel.ScrollToItemCommand = new RelayCommand<int>(index =>
{
    ScrollToTargetItem(index); // 封装上述滚动逻辑的方法
});

注意事项 #

• 若ItemsControl启用虚拟化（如使用VirtualizingStackPanel），需先调用itemsControl.ScrollIntoView(itemsControl.Items[targetIndex])触发容器生成，再执行后续步骤。
• 你的ItemContainerStyle设置了Margin=5，坐标计算会自动包含该间距，无需额外调整。

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