GSDK如何向PDF添加隐藏的文本域？

请参考以下代码：

                    // 添加文本隐藏域
                    Control control = form.addControl(page, "Text Field0", Field.e_TypeTextField, new RectF(50, 600, 90, 640));
                    control.getField().setValue("3");
                    DefaultAppearance defaultAppearance = new DefaultAppearance();
                    // 刷新外观
                    control.getWidget().resetAppearanceStream();

                    int annotCount = page.getAnnotCount();
                    for (int i = 0; i < annotCount; i++) {
                        Annot annot = page.getAnnot(i);
                        // 设置隐藏域的外观不可见
                        annot.setFlags(e_FlagHidden | e_FlagReadOnly);
                        annot.resetAppearanceStream();
                    }

一、创建并配置隐藏文本域

字段初始化与位置设置
代码通过 form.addControl() 方法在 PDF 页面中添加文本域控件。参数依次为：目标页面 page、字段名称 "Text Field0"、字段类型 Field.e_TypeTextField（文本类型），以及坐标区域 new RectF(50, 600, 90, 640)。这里的坐标采用 PDF 坐标系（左下角为原点），表示文本域的位置为：左边界 50、下边界 600、右边界 90、上边界 640，实际占据的矩形区域宽度为 40（90-50）、高度为 40（640-600）。
设置字段值
通过 control.getField().setValue("3") 为文本域赋值 "3"，该值在 PDF 中不可见，但可通过表单数据读取。
外观刷新
创建默认外观对象 DefaultAppearance 后，调用 control.getWidget().resetAppearanceStream() 重置控件的外观流。这一步用于确保字段的视觉呈现被更新，尽管隐藏域本身不显示，但外观刷新是应用隐藏属性的必要步骤。

二、隐藏文本域的外观

遍历页面注释
通过 page.getAnnotCount() 获取当前页面的注释数量，循环遍历每个注释 Annot annot。注释是 PDF 中标记表单字段等元素的对象，文本域的隐藏属性需通过注释的标志位设置。
设置隐藏与只读标志
对每个注释调用 annot.setFlags(e_FlagHidden | e_FlagReadOnly)，其中：
- e_FlagHidden 用于隐藏注释的外观，使文本域在 PDF 中不可见；
- e_FlagReadOnly 使字段变为只读，防止用户修改其值。
刷新注释外观
调用 annot.resetAppearanceStream() 重新生成注释的外观流，确保隐藏和只读属性生效。

关键逻辑总结

遍历所有注释并设置标志位时，建议增加字段名称校验（如通过 annot.getFieldName() 匹配），避免影响其他注释。

核心步骤：创建文本域 → 赋值 → 刷新外观 → 遍历注释并设置隐藏标志。

隐藏原理：通过修改注释的 e_FlagHidden 标志位，而非直接删除字段，使文本域在视觉上不可见，但保留其数据存储功能。

注意事项：

坐标值需根据 PDF 实际尺寸调整，避免与其他元素重叠；

隐藏字段仍可通过 PDF 编辑器的表单查看功能获取值，若需完全安全，需配合 PDF 加密；

【校园昕积分】邀请攻略：使用福昕合作高校发放教育专用激活码激活

【校园昕积分】邀请攻略：使用CARSI高校账户或高校EDU邮箱注册

在福昕高级PDF编辑器中如何自定义快速访问工具栏

在福昕高级PDF编辑器中如何设置常用图章

在对文件虚拟打印后如何设置文件不自动打开

通知消息关闭后如何开启

PDF文件奇偶页差异化页码添加

无法安装服务“Foxit Document Management”(FoxitAssistantSvcPlus)

将3D文件添加作为信任文件

GSDK如何添加一个可提交PDF表单域数据的按钮？