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 存在嵌套链接注释，需确保遍历所有层级。

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

打印管理PrintManager怎么判断文档打印是否完成？

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

打印管理PrintManager怎么判断文档打印是否完成？

软件如何打开嵌入在office文档中Adobe PDF图标

福昕高级PDF编辑器专业版如何在文档中嵌入一个3D模型

福昕高级PDF编辑器专业版如何实现对图片和文档内容添加马赛克

福昕高级PDF编辑器如何显示注释内容图标

福昕高级PDF编辑器如何添加和调整快速访问工具栏功能

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

打印管理PrintManager怎么判断文档打印是否完成？

软件如何打开嵌入在office文档中Adobe PDF图标

福昕高级PDF编辑器专业版如何在文档中嵌入一个3D模型

福昕高级PDF编辑器专业版如何实现对图片和文档内容添加马赛克

福昕高级PDF编辑器如何显示注释内容图标

福昕高级PDF编辑器如何添加和调整快速访问工具栏功能