如何将WPF控件拆分导出至PDF多页？ListView超长分页问题求助

阿华AIGC实验室

2026-5-22

解决WPF ListView导出PDF时无法自动分页的问题

这个问题我之前帮几个开发者解决过——WPF的ListView本质是带滚动的容器，导出PDF时它不会自动帮你拆分长内容，因为它的默认渲染只会考虑当前视口或者控件的整体尺寸，不会感知PDF的分页规则。下面给你两个实用的解决方案，看你的需求选：

方案一：改用FlowDocument承载内容（推荐，最简单）

如果你的内容可以转换成文档式的结构，直接用FlowDocument替代ListView是最省心的方式，因为FlowDocument天生支持分页，WPF的打印/导出系统会自动帮你处理分页逻辑。

具体步骤：

把ListView的ItemTemplate转换成FlowDocument的块元素（比如Paragraph、List、Table），对应每个列表项的内容
将FlowDocument放入FlowDocumentScrollViewer或者FlowDocumentPageViewer中
导出时直接打印FlowDocument到PDF（可以用WPF的PrintDialog选择虚拟PDF打印机，或者用第三方库比如PdfSharp来渲染）

举个简单的转换示例，假设你的列表项是用户信息：

var flowDoc = new FlowDocument();
var list = new List();
foreach (var user in yourUserList)
{
    var listItem = new ListItem(new Paragraph(new Run($"姓名：{user.Name} | 邮箱：{user.Email}")));
    list.ListItems.Add(listItem);
}
flowDoc.Blocks.Add(list);

方案二：手动拆分ListView内容到多页（保留ListView样式）

如果必须保留ListView的样式和视觉一致性，就得手动计算分页，把长内容拆分成多个临时ListView，每个对应PDF的一页。

核心步骤：

测量单个列表项的高度
先获取第一个列表项的高度（如果项高度不固定，建议取所有项的最大高度，避免分页截断）：

// 假设你的ListView名为targetListView
var firstItem = targetListView.ItemContainerGenerator.ContainerFromIndex(0) as ListViewItem;
if (firstItem == null) return;
// 让控件测量自身所需的尺寸
firstItem.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
double singleItemHeight = firstItem.DesiredSize.Height;

计算每页可容纳的项数
按A4页面的可用高度来算（96DPI下，A4高度约1122像素，减去上下边距比如100像素）：

const double A4PageHeight = 1122;
const double PageMargin = 50;
double usablePageHeight = A4PageHeight - 2 * PageMargin;
int itemsPerPage = (int)(usablePageHeight / singleItemHeight);

拆分数据源为多个分页子集
把你的ItemsSource拆分成多个小集合，每个集合对应一页的内容：

var originalItems = targetListView.ItemsSource as IList<YourDataType>;
if (originalItems == null) return;
var pageItemCollections = new List<IEnumerable<YourDataType>>();
for (int i = 0; i < originalItems.Count; i += itemsPerPage)
{
    pageItemCollections.Add(originalItems.Skip(i).Take(itemsPerPage));
}

为每个分页创建临时ListView并渲染
为每个子集创建一个和原ListView样式一致的临时控件，禁用滚动（让所有项展开），然后渲染到PDF的对应页面：

foreach (var pageItems in pageItemCollections)
{
    var tempListView = new ListView
    {
        ItemsSource = pageItems,
        ItemTemplate = targetListView.ItemTemplate,
        Width = targetListView.ActualWidth,
        // 禁用滚动，确保所有项都显示
        ScrollViewer.VerticalScrollBarVisibility = ScrollBarVisibility.Disabled,
        ScrollViewer.HorizontalScrollBarVisibility = ScrollBarVisibility.Disabled
    };
    // 测量并排列控件，让它展开所有内容
    tempListView.Measure(new Size(targetListView.ActualWidth, double.PositiveInfinity));
    tempListView.Arrange(new Rect(0, 0, tempListView.DesiredSize.Width, tempListView.DesiredSize.Height));
    
    // 渲染控件为位图，再添加到PDF
    RenderTargetBitmap rtb = new RenderTargetBitmap(
        (int)tempListView.DesiredSize.Width,
        (int)tempListView.DesiredSize.Height,
        96, 96, PixelFormats.Pbgra32);
    rtb.Render(tempListView);
    
    // 这里根据你用的PDF库（比如iTextSharp、PdfSharp）把rtb转换成PDF图像添加到页面
    // 示例（PdfSharp）：
    // var bitmap = BitmapFrame.Create(rtb);
    // var pdfBitmap = PdfSharp.Drawing.XBitmap.FromBitmapSource(bitmap);
    // gfx.DrawImage(pdfBitmap, PageMargin, PageMargin);
}