WPF实现自动滚动HeaderedItemsControl及现有实现问题排查

你的代码存在以下几处错误：

1. 方法执行顺序错误
   你在OnItemsChanged中先调用ScrollToEnd()再执行base.OnItemsChanged(e)，但基类方法才是负责将新增项同步到可视化树的逻辑，滚动触发时新项还没渲染，自然看不到效果，调换两者执行顺序即可。
2. 控件模板目标类型不匹配
   样式的目标类型是common:ScrollingHeaderedItemsControl，但内部ControlTemplate的TargetType写的是HeaderedItemsControl，类型不匹配可能导致模板绑定异常、视觉树结构和预期不一致，扩展方法按固定索引查询子元素会找不到ScrollViewer，将模板TargetType修改为自定义控件类型即可。
3. 异常被静默吞吃
   ScrollToEnd扩展方法无差别捕获所有异常且不做任何处理，就算视觉树查找失败、ScrollViewer为空抛出异常也不会有任何提示，无法定位问题。
4. 视觉树查找逻辑鲁棒性差
   按固定索引查询视觉子元素的逻辑非常脆弱，只要模板结构稍有调整索引就会失效，建议改用按类型递归查找视觉子元素的通用方案。
5. 小语法错误
   使用控件的XAML代码中，ItemTemplate节点末尾缺少闭合的>，会导致编译报错。

修复后代码 #

1. 自定义控件类

public class ScrollingHeaderedItemsControl : HeaderedItemsControl
{
    protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
    {
        // 先执行基类逻辑，将新项同步到可视化树
        base.OnItemsChanged(e);
        if (e.NewItems != null && e.NewItems.Count > 0)
        {
            // 等待界面渲染完成后再执行滚动，避免视觉树未更新
            Dispatcher.InvokeAsync(ScrollToEnd, System.Windows.Threading.DispatcherPriority.Render);
        }
    }
}

2. 滚动扩展方法

public static class ItemsControlExtensions
{
    public static void ScrollToEnd(this ItemsControl control)
    {
        if (control == null) return;
        var scrollViewer = FindVisualChild<ScrollViewer>(control);
        scrollViewer?.ScrollToEnd();
    }

    // 通用视觉树按类型查找方法
    private static T FindVisualChild<T>(DependencyObject parent) where T : DependencyObject
    {
        if (parent == null) return null;
        for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
        {
            var child = VisualTreeHelper.GetChild(parent, i);
            if (child is T target) return target;
            var res = FindVisualChild<T>(child);
            if (res != null) return res;
        }
        return null;
    }
}

3. 控件样式

<Style TargetType="common:ScrollingHeaderedItemsControl">
    <Setter Property="Template">
        <Setter.Value>
            <!-- 修正模板目标类型 -->
            <ControlTemplate TargetType="{x:Type common:ScrollingHeaderedItemsControl}">
                <Border BorderBrush="{TemplateBinding BorderBrush}" BorderThickness="3" SnapsToDevicePixels="True">
                    <StackPanel>
                        <Grid>
                            <Rectangle Fill="{TemplateBinding Background}"/>
                            <ContentPresenter ContentSource="Header" Margin="2,0,0,0"/>
                        </Grid>
                        <ScrollViewer VerticalScrollBarVisibility="Hidden">
                            <ItemsPresenter Margin="5,0,0,0"/>
                        </ScrollViewer>
                    </StackPanel>
                </Border>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

4. XAML使用示例（修正语法错误）

<common:ScrollingHeaderedItemsControl x:Name="MessagesHIC" FontSize="32" Header="Error/Warning/Info Messages" 
                                      Background="Green" 
                                      BorderBrush="AntiqueWhite" ItemsSource="{Binding Messages}"
                                      Margin="10" Grid.Row="1" Grid.Column="0"
                                      ScrollViewer.CanContentScroll="True">
    <common:ScrollingHeaderedItemsControl.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding MessageString}" Foreground="{Binding MessageColor}" TextWrapping="Wrap" FontWeight="Light" FontSize="26" />
        </DataTemplate>
    </common:ScrollingHeaderedItemsControl.ItemTemplate>
</common:ScrollingHeaderedItemsControl>

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