SVG添加至PDF后被复选框遮挡，如何使其显示在顶层？

问题原因 #

PDF的渲染顺序是先绘制页面内容流，再绘制表单字段的外观。你用Document.Add添加的SVG属于页面内容流的一部分，自然会被表单类型的复选框遮挡。

解决方案 #

方案一：通过印章注释放置SVG（强制显示在顶层）

把原来添加SVG的代码替换成以下逻辑，利用PDF注释会渲染在表单字段上方的特性：

var reader = new PdfReader(pathIn);
var writer = new PdfWriter(pathOut);
var pdfDoc = new PdfDocument(reader, writer);
var page = pdfDoc.GetPage(1);

var checkSvg = @"<svg xmlns=""http://www.w3.org/2000/svg"" width=""16"" height=""16"" fill=""currentColor"" class=""bi bi-check"" viewBox=""0 0 16 16""><path d=""M10.97 4.97a.75.75 0 0 1 1.07 1.05l-3.99 4.99a.75.75 0 0 1-1.08.02L4.324 8.384a.75.75 0 1 1 1.06-1.06l2.094 2.093 3.473-4.425z""/></svg>";

var svgConverter = SvgConverter.ConvertToXObject(checkSvg, pdfDoc);

// 定义SVG的位置和尺寸
float x = 28;
float y = 75;
float width = 30;
float height = 30;

// 创建注释的矩形范围
PdfRectangle rect = new PdfRectangle(x, y, x + width, y + height);
// 创建印章注释
PdfStampAnnotation stamp = new PdfStampAnnotation(rect)
    .SetStampName(new PdfName("CheckMark"));
// 绑定SVG到注释外观
PdfAppearance appearance = new PdfAppearance(pdfDoc);
appearance.AddXObject(svgConverter, 0, 0, width, height);
stamp.SetNormalAppearance(appearance);

// 将注释添加到页面
page.AddAnnotation(stamp);

pdfDoc.Close();

方案二：直接设置表单复选框的选中状态（若为可编辑表单）

如果你的复选框是PDF表单字段，直接修改其状态更简单，无需手动添加SVG：

var reader = new PdfReader(pathIn);
var writer = new PdfWriter(pathOut);
var pdfDoc = new PdfDocument(reader, writer);

// 获取表单对象
PdfAcroForm form = PdfAcroForm.GetAcroForm(pdfDoc, true);
// 替换为实际的复选框字段名称
PdfCheckboxField checkbox = (PdfCheckboxField)form.GetField("YourCheckboxFieldName");
if (checkbox != null)
{
    // 设置为选中状态
    checkbox.SetValue(PdfFormField.TYPE_CHECK);
}

pdfDoc.Close();

方案选择 #

• 方案一：适合所有场景，不管复选框是静态图形还是表单字段，都能确保SVG显示在最上层。
• 方案二：仅适用于可编辑表单字段，生成的勾选标记更符合PDF标准。

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