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

福昕PDF SDK 软件开发工具包 | 福昕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 存在嵌套链接注释，需确保遍历所有层级。

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

GSDK如何修改 PDF 打开时的初始页面布局（如双页显示）？除了布局，还能设置哪些初始视图参数？

GSDK如何通过代码控制 PDF 书签的折叠 / 展开状态？书签的 Count 属性具体含义是什么？

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

GSDK如何修改 PDF 打开时的初始页面布局（如双页显示）？除了布局，还能设置哪些初始视图参数？

GSDK如何通过代码控制 PDF 书签的折叠 / 展开状态？书签的 Count 属性具体含义是什么？

福昕高级PDF编辑器专业版+如何实现手机遥控PDF文档

福昕高级PDF编辑器专业版+如何实现批量对文档名称重命名

福昕高级PDF编辑器专业版+如何快速将发票生成报销单

福昕高级PDF编辑器专业版+如何将PDF转换为office格式实现在线编辑

电子签章对外签署如何实现批量签署文档

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

GSDK如何修改 PDF 打开时的初始页面布局（如双页显示）？除了布局，还能设置哪些初始视图参数？

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

GSDK如何通过代码控制 PDF 书签的折叠 / 展开状态？书签的 Count 属性具体含义是什么？

福昕高级PDF编辑器专业版+如何实现手机遥控PDF文档

福昕高级PDF编辑器专业版+如何实现批量对文档名称重命名

福昕高级PDF编辑器专业版+如何快速将发票生成报销单

福昕高级PDF编辑器专业版+如何将PDF转换为office格式实现在线编辑