QuestPDF中实现文本与数字对齐的几种方法

在文档生成工具QuestPDF中，实现文本与数字的对齐是一个常见需求。本文将介绍几种在QuestPDF中实现这种对齐效果的有效方法，帮助开发者创建更专业的文档布局。

固定宽度列方法

最可靠的方法是预先估计内容大小，并将其划分为固定宽度的列。这种方法利用了页面尺寸固定的特点，可以创建稳定的布局结构。

var content = new[]
{
    ("总金额HT:", "1234.56 €"),
    ("增值税率:", "20 %"),
    ("增值税额:", "246.91 €"),
    ("总金额TTC:", "1481.47 €")
};

container
    .Padding(20)
    .AlignRight()
    .Column(column =>
    {
        foreach (var item in content)
        {
            column.Item().AlignRight().Row(row =>
            {
                row.AutoItem().Text(item.Item1).Bold();
                row.ConstantItem(100).AlignRight().Text(item.Item2);
            });
        }
    });

这种方法的关键点在于：

1. 使用固定宽度的列(ConstantItem)来确保数值部分对齐
2. 通过AlignRight()实现右对齐
3. 标签和数值分别放在不同的列中

表格布局方法

另一种更结构化的方式是使用表格布局，这种方法特别适合有多行对齐需求的场景：

container.Table(table =>
{
    table.ColumnsDefinition(columns =>
    {
        columns.ConstantColumn(100); // 标签列
        columns.ConstantColumn(100); // 数值列
    });

    table.Cell().Text("总金额HT:").Bold();
    table.Cell().AlignRight().Text("1234.56 €");

    table.Cell().Text("增值税率:").Bold();
    table.Cell().AlignRight().Text("20 %");
    
    // 其他行...
});

表格方法的优势在于：

• 结构清晰，易于维护
• 自动处理行高和间距
• 可以轻松添加边框等装饰元素

等宽字体与空格填充

对于简单的对齐需求，可以使用等宽字体配合空格字符来实现对齐效果：

container.AlignRight().Text(text =>
{
    text.Span("总金额HT: ").FontFamily("Courier New");
    text.Span("1234.56 €").FontFamily("Courier New");
    
    text.EmptyLine();
    
    text.Span("增值税率: ").FontFamily("Courier New");
    text.Span("20 %").FontFamily("Courier New");
});

注意事项：

• 必须使用真正的等宽字体(如Courier New)
• 可以使用不间断空格字符(\u00A0)来确保空格不被压缩
• 这种方法在小字体下效果最佳

实际应用建议

在实际项目中，建议根据具体场景选择合适的方法：

1. 对于发票、报表等专业文档，推荐使用表格方法，因为它提供了最好的控制力和可扩展性。

2. 对于简单的键值对显示，固定宽度列方法更加轻量级且易于实现。

3. 等宽字体方法最适合快速原型开发或对格式要求不严格的场景。

无论选择哪种方法，都建议在实现后进行多设备预览，确保在不同分辨率和纸张尺寸下都能保持预期的对齐效果。