iText 7 for .NET 多行表单字段忽略并重置文本对齐问题

我之前从iTextSharp 5.x升级到iText 7时，也碰到过完全一样的问题！确实，iText 7对多行文本字段的渲染逻辑做了调整，默认会忽略原有字段的对齐设置，导致文本强制左对齐。下面是我亲测有效的几种解决办法：

方法1：用Paragraph对象包裹文本（最可靠） #

iText 7中，多行字段更推荐用Paragraph来定义文本格式，这样能精准控制对齐方式，完全规避默认逻辑的限制。代码示例如下：

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.Layout.Properties;
using iText.Forms;
using iText.Forms.Fields;

// 打开目标PDF文档
PdfDocument pdfDoc = new PdfDocument(new PdfReader("your_input.pdf"), new PdfWriter("your_output.pdf"));
PdfAcroForm form = PdfAcroForm.GetAcroForm(pdfDoc, true);

// 获取需要填充的多行字段
PdfTextFormField multiLineField = (PdfTextFormField)form.GetField("YourMultiLineFieldName");

if (multiLineField != null && multiLineField.IsMultiline())
{
    // 创建段落并设置对齐方式（可选值：LEFT/CENTER/RIGHT）
    Paragraph contentPara = new Paragraph("这里是需要填充的多行文本内容\n支持换行显示")
        .SetTextAlignment(TextAlignment.CENTER) // 替换成你需要的对齐方式
        .SetMargin(0); // 清除默认边距，避免字段内布局偏移
    
    // 将段落设置为字段值
    multiLineField.SetValue(contentPara);
}

// 如果需要扁平化表单（可选操作，填充后移除表单交互性）
// form.FlattenFields();

pdfDoc.Close();

方法2：直接设置字段的Q属性 #

PDF表单字段本身有个Q属性专门控制文本对齐（0=左对齐，1=居中，2=右对齐），可以直接给多行字段赋值这个属性来强制对齐：

if (multiLineField != null && multiLineField.IsMultiline())
{
    // 设置为居中对齐（Q=1），按需替换为0或2
    multiLineField.SetProperty(PdfName.Q, new PdfNumber(1));
    multiLineField.SetValue("这里是需要填充的多行文本内容");
}

注意：这种方法在某些特殊字段定义下可能不生效，比如原有PDF字段的外观字典有硬编码的对齐逻辑，这时候方法1的兼容性会更好。

额外提示 #

• 确保你使用的是最新版本的iText 7 for .NET，官方在后续版本中修复了不少表单字段的兼容性问题；
• 如果字段填充后还是有对齐异常，可以检查原有PDF中该字段的外观设置，是否存在自定义的外观流覆盖了对齐规则。

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