如何使用PDFBox锁定/解锁PDF图层？附启用/禁用图层示例代码

好问题！你已经掌握了PDFBox中启用/禁用图层（可选内容组，OCG）的基础操作，其实PDFBox完全支持锁定/解锁图层的功能——这对应着PDF规范里可选内容组的locked属性。

核心逻辑 #

锁定图层的作用是禁止用户在PDF阅读器中手动修改该图层的可见性状态（即使你通过代码可以调整它的启用/禁用状态）；解锁则会恢复用户修改可见性的权限。

示例代码（基于你的现有代码扩展） #

PDDocument document = PDDocument.load(new File("layers.pdf"));
PDDocumentCatalog catalog = document.getDocumentCatalog();
PDOptionalContentProperties ocprops = catalog.getOCProperties();
PDOptionalContentGroup group = ocprops.getGroup(layerName);

if (group != null) {
    // 锁定图层：设置locked属性为true
    group.setLocked(true);
    
    // 解锁图层：设置locked属性为false
    // group.setLocked(false);
    
    // 保存修改后的文档
    document.save("layers_with_locked_layer.pdf");
}

document.close();

注意事项 #

• 务必先判断PDOptionalContentGroup是否为null，避免空指针异常（比如传入的layerName不存在时）。
• 修改完成后一定要调用document.save()和document.close()，否则所有修改都不会被持久化到文件中。
• locked属性只限制用户的手动交互操作，通过PDFBox代码仍然可以自由调整图层的启用/禁用状态。

内容的提问来源于stack exchange，提问作者swarupn