调用FlattenFields()后如何让PDF下拉框显示选项文本而非值？

问题根源 #

PDF下拉框（单选列表类型字段）的每个选项都包含显示文本（如"Hong Kong"）和导出值（如"HKG"）。调用SetValue("HKG")时，你设置的是字段的导出值：

• 未扁平化时，PDF阅读器会自动匹配导出值对应的显示文本进行渲染；
• 调用FlattenFields()时，默认会直接将字段内部存储的导出值渲染为文本，而非使用显示文本。

解决方案 #

要让扁平化后显示"Hong Kong"，需要先让字段生成对应显示文本的外观，再执行扁平化操作。具体代码如下：

PdfAcroForm form = PdfAcroForm.GetAcroForm(pdfDoc, true);
// 将目标字段转换为下拉框类型（PdfChoiceFormField）
PdfChoiceFormField countryField = (PdfChoiceFormField)form.GetField("country");

// 设置字段的导出值，匹配对应的选项
countryField.SetValue("HKG");
// 强制重新生成字段外观，确保使用显示文本渲染
countryField.RegenerateField();

// 执行扁平化操作
form.FlattenFields();

补充方案（若上述方法不生效） #

手动匹配导出值对应的显示文本，直接设置为字段值后再扁平化：

PdfAcroForm form = PdfAcroForm.GetAcroForm(pdfDoc, true);
PdfChoiceFormField countryField = (PdfChoiceFormField)form.GetField("country");

string targetDisplayText = null;
// 遍历下拉框选项，找到导出值"HKG"对应的显示文本
foreach (var option in countryField.GetOptions())
{
    if (option.GetValue().ToString().Equals("HKG"))
    {
        targetDisplayText = option.GetDisplayText();
        break;
    }
}

if (!string.IsNullOrEmpty(targetDisplayText))
{
    // 直接设置字段值为显示文本
    countryField.SetValue(targetDisplayText);
    form.FlattenFields();
}

内容的提问来源于stack exchange，提问作者J.Y.527