GSDK如何设置 PDF 中链接注释的高亮模式（如取消高亮）？链接高亮有哪些可选模式？

福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(桌面/服务器)

标签:
注释

GSDK如何设置 PDF 中链接注释的高亮模式（如取消高亮）？链接高亮有哪些可选模式？

福昕知识库
2025-12-08

PDF 链接注释（Link Annot）的高亮样式由HighlightingMode属性控制，Foxit SDK 提供了 4 种预设模式，可通过Link.setHighlightingMode()修改，具体如下：

高亮模式枚举释义

枚举值	含义	视觉效果
e_HighlightingNone	无高亮	点击链接无任何视觉变化
e_HighlightingInvert	反色高亮	点击时链接区域颜色反转
e_HighlightingOutline	轮廓高亮	点击时显示链接边框
e_HighlightingPush	按压效果（默认）	点击时链接区域呈 “凹陷” 效果

import com.foxit.sdk.PDFDoc;
import com.foxit.sdk.PDFPage;
import com.foxit.sdk.Annot;
import com.foxit.sdk.Link;
import com.foxit.sdk.common.ErrorCode;

public class LinkHighlightDemo {
    public static void main(String[] args) {
        // 初始化SDK（省略）
        PDFDoc doc = new PDFDoc("test.pdf");
        if (doc.load(null) != ErrorCode.e_ErrSuccess) {
            System.out.println("文档加载失败");
            return;
        }

        // 遍历所有页面
        int pageCount = doc.getPageCount();
        for (int pageIdx = 0; pageIdx < pageCount; pageIdx++) {
            PDFPage page = doc.getPage(pageIdx);
            if (page == null) continue;

            // 遍历当前页面所有注释
            int annotCount = page.getAnnotCount();
            for (int annotIdx = 0; annotIdx < annotCount; annotIdx++) {
                Annot annot = page.getAnnot(annotIdx);
                // 仅处理链接注释
                if (annot.getType() == Annot.e_TypeLink) {
                    Link link = new Link(annot);
                    // 设置为“无高亮”模式
                    link.setHighlightingMode(Link.e_HighlightingNone);
                    // 重置外观流（必须执行，否则样式不生效）
                    link.resetAppearanceStream();
                    System.out.println("页面" + (pageIdx+1) + "链接" + (annotIdx+1) + "高亮已取消");
                }
            }
            page.release(); // 释放页面资源
        }

        // 保存修改
        doc.save(PDFDoc.e_SaveFlagNoIncremental, null);
        doc.close();
        Library.release();
    }
}

注意事项

重置外观流：修改高亮模式后必须调用resetAppearanceStream()，否则 PDF 阅读器仍会显示旧样式；
注释权限：若文档有权限保护（如禁止修改注释），需先解除权限限制；
嵌套链接：部分 PDF 存在嵌套链接注释，需确保遍历所有层级。

在合并文件时如何统一设置页面大小

文件每次打开时缩放比例都是200%如何将缩放比例调整为100%

如何查看查看PDF/A的版本信息

如何使用电子签章对内签署

电子签章签署后如何查看相关签署记录

在合并文件时如何统一设置页面大小

文件每次打开时缩放比例都是200%如何将缩放比例调整为100%

如何查看查看PDF/A的版本信息

如何使用电子签章对内签署

电子签章签署后如何查看相关签署记录

电子签章对外签署如何在软件上实现签署时自动添加签署日期

电子签章对外签署如何在软件上分配印章使用权

电子签章对外签署如何邀请他人签署

电子签章对外签署如何实现签署时自动添加签署日期

电子签章对外签署如何进行文档直接签署

在合并文件时如何统一设置页面大小

文件每次打开时缩放比例都是200%如何将缩放比例调整为100%

如何查看查看PDF/A的版本信息

如何使用电子签章对内签署

电子签章签署后如何查看相关签署记录

电子签章对外签署如何在软件上实现签署时自动添加签署日期

电子签章对外签署如何在软件上分配印章使用权

电子签章对外签署如何邀请他人签署

电子签章对外签署如何实现签署时自动添加签署日期

电子签章对外签署如何进行文档直接签署