【wpf】 WPF中实现动态加载图片浏览器(边滚动边加载)

WPF中实现动态加载图片浏览器(边滚动边加载)

在做图片浏览器程序时,遇到图片数量巨大的情况(如几百张、上千张),一次性加载所有图片会导致界面卡顿甚至程序崩溃。

本文介绍一种 WPF + Prism 实现动态分页加载图片 的方法,结合 ScrollViewer 滚动条触底检测,实现 "边滚动,边加载" 的流畅体验。

1. 界面设计:4×4 显示 + 滚动条

我们希望界面每次显示 4×4,共 16 张图片,每张图片带有边框。

XAML示例

xml 复制代码
<ScrollViewer VerticalScrollBarVisibility="Auto" ScrollChanged="ScrollViewer_ScrollChanged">
    <ItemsControl ItemsSource="{Binding Images}">
        <ItemsControl.ItemsPanel>
            <ItemsPanelTemplate>
                <UniformGrid Columns="4"/>
            </ItemsPanelTemplate>
        </ItemsControl.ItemsPanel>
        <ItemsControl.ItemTemplate>
            <DataTemplate>
                <Border BorderBrush="Gray" BorderThickness="1" Margin="5">
                    <Image Source="{Binding}" Stretch="Uniform"/>
                </Border>
            </DataTemplate>
        </ItemsControl.ItemTemplate>
    </ItemsControl>
</ScrollViewer>
  • ScrollViewer 包裹 ItemsControl,开启垂直滚动。
  • 使用 UniformGrid 布局,4列均匀分布。
  • 每张图片用 Border 包一层,美观且清晰分隔。

2. 后台逻辑:ViewModel 分页加载

ViewModel 负责管理图片列表和分页逻辑。

csharp 复制代码
public class ImageBrowserViewModel : BindableBase
{
    private const int PageSize = 16;
    private readonly List<string> allImagePaths = new();
    public ObservableCollection<BitmapImage> Images { get; } = new();

    private int currentPage = 0;
    public bool IsLoading { get; private set; }

    public void LoadAllImagePaths(string folderPath)
    {
        allImagePaths.Clear();
        var extensions = new[] { ".jpg", ".png", ".bmp" };
        var files = Directory.GetFiles(folderPath)
            .Where(f => extensions.Contains(Path.GetExtension(f).ToLower()))
            .ToList();
        allImagePaths.AddRange(files);
        currentPage = 0;
        Images.Clear();
    }

    public async Task LoadNextPageAsync()
    {
        if (IsLoading) return;
        IsLoading = true;

        var nextImages = allImagePaths
            .Skip(currentPage * PageSize)
            .Take(PageSize)
            .ToList();

        foreach (var path in nextImages)
        {
            await Task.Run(() =>
            {
                var bitmap = new BitmapImage();
                bitmap.BeginInit();
                bitmap.CacheOption = BitmapCacheOption.OnLoad;
                bitmap.UriSource = new Uri(path);
                bitmap.EndInit();
                bitmap.Freeze();

                App.Current.Dispatcher.Invoke(() => Images.Add(bitmap));
            });
        }

        currentPage++;
        IsLoading = false;
    }
}
  • LoadAllImagePaths:一次性记录所有图片路径,但不立刻加载图片内容。
  • LoadNextPageAsync:每次按页加载图片,使用 Task.Run + Dispatcher.Invoke,避免界面卡顿。

这段代码的作用是从 allImagePaths 列表中取出当前页面所需的图片路径,并将它们存储到 nextImages 列表中。以下是逐行解释:

代码片段

csharp 复制代码
var nextImages = allImagePaths
    .Skip(currentPage * PageSize)
    .Take(PageSize)
    .ToList();

逐行解释

  1. var nextImages:

    • 声明一个变量 nextImages,用于存储当前页面所需的图片路径列表。
  2. allImagePaths:

    • 这是一个包含所有图片路径的列表,类型为 List<string>
  3. .Skip(currentPage * PageSize):

    • currentPage 是当前页面的索引,从 0 开始。
    • PageSize 是每页显示的图片数量,这里定义为 16。
    • currentPage * PageSize 计算出当前页面之前的所有图片路径的数量。
    • .Skip(currentPage * PageSize) 跳过这些路径,即跳过当前页面之前的所有图片路径。
  4. .Take(PageSize):

    • 从跳过后的路径中取出 PageSize 个路径,即取出当前页面所需的图片路径。
  5. .ToList():

    • 将取出的路径转换为一个新的列表,并赋值给 nextImages

总结

这段代码的作用是从 allImagePaths 中取出当前页面所需的图片路径,并将它们存储到 nextImages 列表中。具体来说,它跳过了当前页面之前的所有图片路径,然后取出当前页面所需的图片路径数量(PageSize 个),并将这些路径存储到 nextImages 列表中。

3. 滚动到底时加载新图片

ScrollViewerScrollChanged 事件中,检测是否接近底部,如果是则请求 ViewModel 加载下一页:

csharp 复制代码
private async void ScrollViewer_ScrollChanged(object sender, ScrollChangedEventArgs e)
{
    var scrollViewer = (ScrollViewer)sender;

    if (scrollViewer.VerticalOffset + scrollViewer.ViewportHeight 
        >= scrollViewer.ExtentHeight - 50) // 接近底部50像素
    {
        if (DataContext is ImageBrowserViewModel vm && !vm.IsLoading)
        {
            await vm.LoadNextPageAsync();
        }
    }
}

ExtentHeight 是总高度,ViewportHeight 是当前可视区域高度,VerticalOffset 是当前滚动位置。

当滚动接近底部 50px 内,就触发加载。

4. 总结

通过以上方法,我们实现了:

  • 初始只加载少量图片,快速打开界面。
  • 用户滚动时,按需分页加载后续图片。
  • 界面不卡顿,体验丝滑流畅。

这种设计特别适合处理大量图片浏览、视频帧查看、缩略图管理器等场景。

相关推荐
甄天10 小时前
WPF数据绑定
c#·wpf
Magnum Lehar13 小时前
wpf游戏引擎主界面实现3
ui·游戏引擎·wpf
Magnum Lehar15 小时前
wpf主界面游戏引擎实现
游戏引擎·wpf
沉着的码农18 小时前
【分布式】基于Redisson实现对分布式锁的注解式封装
java·spring boot·redis·分布式·wpf
爱吃煎蛋的小新2 天前
WPF入门 #1 WPF布局基础
笔记·学习·c#·wpf
✎ ﹏梦醒͜ღ҉繁华落℘2 天前
WPF学习(二)
学习·wpf
BearHan2 天前
非常'肤浅'的理解MVVM
wpf
ou.cs2 天前
wpf 控件开发中,OnApplyTemplate 和 OnContentRendered区别
c#·.net·wpf
界面开发小八哥3 天前
界面组件DevExpress WPF中文教程:Grid - 节点(Nodes)概述
.net·wpf·界面控件·devexpress·ui开发