iTextSharp展平PDF表单域后填写内容被印章遮挡如何解决

你的PDF模板中的印章属于PDF注释（Annotation）对象，默认悬浮在页面基础内容层之上。iTextSharp 5.x开启FormFlattening时，只会将表单域内容写入页面基础内容层，不会处理注释类对象，因此展平后下层的表单内容就会被上层的印章注释遮挡。不展平时表单域本身也是注释类型，层级比印章注释高，所以能正常显示在上层。

两种可行修复方式按需选择即可：

方案1：同步展平注释并调整层级（首选） #

在原有代码基础上新增注释展平配置，强制表单内容绘制优先级高于印章：

// 原有表单填充逻辑不变
var fields = stamper.AcroFields;
stamper.AcroFields.SetFieldProperty(fieldName, "textsize", fontSize, null);
fields.SetField(fieldName, value);
fields.SetFieldProperty(fieldName.ToString(),
    "setfflags",
    PdfFormField.FF_READ_ONLY,
    null); 

// 新增2行配置
stamper.FormFlattening = true;
stamper.AnnotationFlattening = true;

该方案会同时将表单域和印章注释都合并到PDF内容层，表单内容默认绘制在上层，不会被遮挡。

方案2：调整操作顺序适配特殊印章 #

如果方案1对当前模板的印章不生效，可以调整操作顺序，先把印章合并到下层再填充表单：

// 第一步：先将印章类注释展平到内容下层
stamper.AnnotationFlattening = true;
stamper.Writer.CloseStream = false;

// 第二步：执行原有表单填充逻辑
var fields = stamper.AcroFields;
stamper.AcroFields.SetFieldProperty(fieldName, "textsize", fontSize, null);
fields.SetField(fieldName, value);
fields.SetFieldProperty(fieldName.ToString(),
    "setfflags",
    PdfFormField.FF_READ_ONLY,
    null); 

// 第三步：最后展平表单，内容会写入到上层
stamper.FormFlattening = true;

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