WinUI3 C++桌面应用：实现ListView滚动时增量加载内容

核心思路 #

无需直接获取滚动行数，而是通过判断ScrollViewer的垂直滚动位置是否接近底部触发加载逻辑；若需要精确控制加载数量，可结合ListView的容器信息或预设项高度计算待加载项数。

具体实现步骤 #

1. 可靠获取ListView内部的ScrollViewer #

用视觉树遍历的方式获取内置ScrollViewer：

#include <winrt/Windows.UI.Xaml.Controls.h>
#include <winrt/Windows.UI.Xaml.Media.h>

winrt::Windows::UI::Xaml::Controls::ScrollViewer GetListViewScrollViewer(winrt::Windows::UI::Xaml::Controls::ListView const& listView)
{
    auto rootChild = winrt::Windows::UI::Xaml::Media::VisualTreeHelper::GetChild(listView, 0);
    return rootChild.as<winrt::Windows::UI::Xaml::Controls::ScrollViewer>();
}

2. 监听滚动事件并判断加载时机 #

在ViewChanged事件中，计算滚动偏移与可滚动高度的关系，当接近底部时触发加载：

void OnScrollViewChanged(winrt::Windows::UI::Xaml::Controls::ScrollViewer const& sender, winrt::Windows::UI::Xaml::Controls::ScrollViewerViewChangedEventArgs const& args)
{
    // 仅在滚动结束后触发，避免频繁加载
    if (!args.IsIntermediate())
    {
        double scrollableHeight = sender.ScrollableHeight();
        double verticalOffset = sender.VerticalOffset();
        double viewportHeight = sender.ViewportHeight();

        // 当滚动到距离底部小于视口高度20%时触发加载
        if (verticalOffset + viewportHeight >= scrollableHeight - viewportHeight * 0.2)
        {
            LoadMoreItems();
        }
    }
}

3. 计算待加载项数并更新数据源 #

如果是固定高度的列表项，可通过视口高度计算待加载数量；若是可变高度，可通过最后一个可见项判断：

// 固定高度项的加载数量计算
int CalculateFixedHeightItemsToLoad(winrt::Windows::UI::Xaml::Controls::ListView const& listView)
{
    const double fixedItemHeight = 45; // 替换为你的项实际高度
    double viewportHeight = listView.ActualHeight();
    // 加载1.5倍视口的项数，减少频繁加载次数
    return static_cast<int>(viewportHeight / fixedItemHeight * 1.5);
}

void LoadMoreItems()
{
    auto itemsSource = listView.ItemsSource().as<winrt::Windows::Foundation::Collections::IObservableVector<YourDataItem>>();
    int currentCount = itemsSource.Size();
    int itemsToLoad = CalculateFixedHeightItemsToLoad(listView);
    int totalDataCount = 100000;

    // 防止超出总数据量
    int endIndex = min(currentCount + itemsToLoad, totalDataCount);
    if (currentCount >= totalDataCount) return;

    // 异步加载数据（避免阻塞UI）
    winrt::fire_and_forget([=]() -> winrt::Windows::Foundation::IAsyncAction
    {
        co_await winrt::resume_background();
        // 模拟从数据源获取下一批数据
        for (int i = currentCount; i < endIndex; ++i)
        {
            YourDataItem newItem;
            // 填充newItem数据
            co_await winrt::resume_foreground(listView.Dispatcher());
            itemsSource.Append(newItem);
        }
    });
}

4. 可变高度项的适配处理 #

如果项高度不固定，通过ItemContainerGenerator判断最后一个项是否可见，再触发加载：

bool IsLastItemVisible(winrt::Windows::UI::Xaml::Controls::ListView const& listView)
{
    auto generator = listView.ItemContainerGenerator();
    int lastIndex = listView.Items().Size() - 1;
    if (lastIndex < 0) return false;

    auto lastContainer = generator.ContainerFromIndex(lastIndex).as<winrt::Windows::UI::Xaml::Controls::ListViewItem>();
    if (!lastContainer) return false;

    auto transform = lastContainer.TransformToVisual(listView);
    winrt::Windows::Foundation::Point containerPos = transform.TransformPoint({0, 0});
    // 判断项是否在视口范围内
    return containerPos.Y + lastContainer.ActualHeight() >= 0 && containerPos.Y <= listView.ActualHeight();
}

修改OnScrollViewChanged中的判断逻辑：

if (IsLastItemVisible(listView))
{
    LoadMoreItems();
}

关键注意事项 #

• 加载数据时必须异步处理，避免UI线程阻塞。
• 加载前要判断是否已加载完所有数据，防止无效调用。
• 可根据需求调整触发加载的阈值（比如距离底部的像素数或比例）。

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