iText7：如何设置非iText创建的复选框组仅选中单个选项

我从非iText创建的可编辑表单中读取字段属性，现有一个名为AbcField的复选框组，其中YES的导出值为yes，NO的导出值为no。

执行以下代码后：

if (fields.TryGetValue(kvp.Key, out PdfFormField formField))
{
    if (formField is PdfButtonFormField)
    {
        var buttonField = formField as PdfButtonFormField;
        buttonField.SetRadiosInUnison(false);
        buttonField.SetValue(kvp.Value, true);
    }

仍出现多选项被选中的情况（YES和NO同时被勾选）。

请问如何实现仅选中一个选项？

编辑：我找到一个可行但类似hack的解决方案，希望获得更优方法，代码如下：

if (formField is PdfButtonFormField)
{
    var buttonField = formField as PdfButtonFormField;
    var options = fields.Where(x => x.Key.Contains($"{kvp.Key}."));

    buttonField.SetRadiosInUnison(false);

    if (options != null && options.Any())
    {
        foreach (var option in options)
        {
            var optionField = option.Value;
            if (optionField != null)
            {
                optionField.SetCheckType(PdfFormField.TYPE_CROSS);
                var ap = optionField.GetPdfObject()?.GetAsDictionary(PdfName.AP);
                if (ap != null)
                {
                    var d = ap.GetAsDictionary(PdfName.D);
                    var n = ap.GetAsDictionary(PdfName.N);
                    var entrySet = d != null ? d.EntrySet().Select(x => x.Key).ToList() :
                        n?.EntrySet().Select(x => x.Key).ToList();

                    if (entrySet != null)
                    {
                        foreach (var entry in entrySet)
                        {
                            var entryText = entry.ToString();
                            
                            if (entryText.Equals($"/{kvp.Value}", StringComparison.InvariantCultureIgnoreCase))
                            {
                                optionField.SetValue(kvp.Value);
                            }
                        }
                    }
                    
                }
            }
        }
    }

问题根源在于非iText创建的PDF表单中，复选框组的结构可能不符合iText预期的单选组规范——通常单选组需要共享同一个字段名，且每个选项设置不同的导出值，但第三方工具生成的表单可能把每个选项拆成了独立字段（命名类似AbcField.YES、AbcField.NO），导致iText的SetRadiosInUnison无法正确识别组关系。

推荐以下更简洁的优化方案：

1. 明确识别组内所有选项字段：通过字段名前缀匹配找到组内所有选项（比如以AbcField.开头的字段）。
2. 批量取消所有选项选中状态：先遍历组内所有选项，将其值设为null或空字符串，确保没有预选中项。
3. 单独设置目标选项为选中状态：找到与目标导出值匹配的选项，设置其值。

代码实现：

if (formField is PdfButtonFormField buttonField)
{
    // 获取当前组的所有子选项字段（假设命名格式为 组名.选项名）
    var groupOptions = fields.Where(x => x.Key.StartsWith($"{kvp.Key}.", StringComparison.InvariantCultureIgnoreCase))
                             .Select(x => x.Value as PdfButtonFormField)
                             .Where(f => f != null);

    // 先取消所有选项的选中状态
    foreach (var option in groupOptions)
    {
        option.SetValue(null);
    }

    // 找到目标选项并设置选中
    var targetOption = groupOptions.FirstOrDefault(opt => 
        string.Equals(opt.GetValueAsString(), kvp.Value, StringComparison.InvariantCultureIgnoreCase) ||
        // 若导出值和字段值不匹配，可直接通过选项名匹配
        opt.GetFieldName().EndsWith($".{kvp.Value}", StringComparison.InvariantCultureIgnoreCase)
    );
    
    if (targetOption != null)
    {
        targetOption.SetValue(kvp.Value);
    }
}

关键说明： #

• 先清空再选中：确保之前的选中状态被完全清除，避免多选项同时选中。
• 灵活匹配选项：同时支持导出值匹配和字段名后缀匹配，适配第三方表单的不同命名规则。
• 避免操作AP字典：无需直接修改外观字典（AP），通过iText提供的SetValue方法即可正确更新选中状态和外观，更符合API规范。

内容的提问来源于stack exchange，提问作者Outside the Box Developer