【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. 总结

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

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

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

相关推荐
baivfhpwxf20235 小时前
WPF 颜色间的转换 Color,Brush
wpf
Java Fans1 天前
WPF使用SQLite与JSON文本文件结合存储体侧平衡数据的设计与实现
sqlite·json·wpf
code_shenbing1 天前
WPF高级用法示例
c#·wpf·wpf高级
冰茶_1 天前
WPF之XAML基础
microsoft·微软·c#·.net·wpf·xaml·xamarin
呼Lu噜1 天前
WPF-遵循MVVM框架创建图表的显示【保姆级】
前端·后端·wpf
Zhen (Evan) Wang2 天前
.NET 6 + Dapper + User-Defined Table Type
sqlserver·c#·.net·wpf
界面开发小八哥3 天前
界面控件DevExpress WPF v25.1预览 - 支持Windows 11系统强调色
windows·wpf·界面控件·devexpress·ui开发·.net 9
军训猫猫头3 天前
89.WPF 中实现便捷的数字输入框:DecimalUpDown 控件的使用 WPF例子 C#例子.
开发语言·c#·wpf
Pasregret3 天前
缓存与数据库一致性深度解析与解决方案
数据库·缓存·wpf