如何使用iTextsharp为PDF添加单选按钮图片（含选中状态）

我来帮你搞定用iTextSharp在PDF里添加带选中状态的单选按钮这件事！下面是一步步的实操指南，附带完整代码示例，确保你的单选按钮能正常交互且选中状态正确显示。

1. 先搞定引用依赖 #

首先确保你已经引用了iTextSharp的相关命名空间，代码里需要用到这些：

using iTextSharp.text;
using iTextSharp.text.pdf;
using System.IO;

2. 创建PDF文档并初始化表单对象 #

我们需要先创建基础的PDF文档，然后通过PdfWriter获取表单操作的核心对象AcroFields：

// 创建新PDF文档
Document document = new Document(PageSize.A4);
// 写入到指定文件
using (FileStream fs = new FileStream("RadioButtonDemo.pdf", FileMode.Create))
{
    PdfWriter writer = PdfWriter.GetInstance(document, fs);
    document.Open();
    
    // 获取表单操作对象，所有表单控件都通过它来添加和配置
    AcroFields form = writer.AcroFields;

3. 添加单选按钮组（核心步骤） #

单选按钮是成组互斥的，所以我们要给同一组的按钮设置相同的GroupName，同时给每个按钮设置唯一的Value（用来标识选中状态）。

下面是添加两个单选按钮的示例：

// 定义单选按钮的位置和大小（x, y, 宽度, 高度）
Rectangle rect1 = new Rectangle(100, 700, 120, 720);
Rectangle rect2 = new Rectangle(200, 700, 220, 720);

// 创建第一个单选按钮：选项1
RadioCheckField radio1 = new RadioCheckField(writer, rect1, "radio_group", "option1");
radio1.CheckType = RadioCheckField.TYPE_CIRCLE; // 设置为圆形单选按钮
form.AddField(radio1.RadioField);

// 创建第二个单选按钮：选项2
RadioCheckField radio2 = new RadioCheckField(writer, rect2, "radio_group", "option2");
radio2.CheckType = RadioCheckField.TYPE_CIRCLE;
form.AddField(radio2.RadioField);

这里划重点！"radio_group"是组名，两个按钮必须用同一个组名，这样才能实现“选了一个就不能选另一个”的互斥效果；"option1"和"option2"是每个按钮的唯一值，后续用来设置选中状态。

4. 设置默认选中状态 #

要让某个单选按钮默认选中，只需要调用form.SetField()方法，传入组名和要选中的按钮值即可：

// 设置"option1"为默认选中状态
form.SetField("radio_group", "option1");

5. 完整代码示例 #

把所有步骤整合起来，完整的可运行代码如下：

using iTextSharp.text;
using iTextSharp.text.pdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        Document document = new Document(PageSize.A4);
        using (FileStream fs = new FileStream("RadioButtonDemo.pdf", FileMode.Create))
        {
            PdfWriter writer = PdfWriter.GetInstance(document, fs);
            document.Open();
            AcroFields form = writer.AcroFields;

            // 添加单选按钮组
            Rectangle rect1 = new Rectangle(100, 700, 120, 720);
            RadioCheckField radio1 = new RadioCheckField(writer, rect1, "radio_group", "option1");
            radio1.CheckType = RadioCheckField.TYPE_CIRCLE;
            form.AddField(radio1.RadioField);

            Rectangle rect2 = new Rectangle(200, 700, 220, 720);
            RadioCheckField radio2 = new RadioCheckField(writer, rect2, "radio_group", "option2");
            radio2.CheckType = RadioCheckField.TYPE_CIRCLE;
            form.AddField(radio2.RadioField);

            // 设置默认选中项
            form.SetField("radio_group", "option1");

            document.Close();
        }
    }
}

关键注意事项 #

• 必须确保同一组的单选按钮组名完全一致，否则无法实现互斥效果
• 设置选中状态时，传入的按钮值必须和创建按钮时设置的Value完全匹配，大小写也要注意
• 保存后的PDF要用支持表单交互的阅读器打开（比如Adobe Acrobat Reader），部分轻量PDF阅读器可能不支持表单控件的交互和状态显示

内容的提问来源于stack exchange，提问作者R.Pandinus