如何在Adobe Acrobat JavaScript中检测自定义图章是否存在

本文详细介绍了在Adobe Acrobat JavaScript环境中，如何通过巧妙利用图章尺寸默认行为来判断用户是否安装了特定的自定义图章。当尝试添加一个不存在的图章时，Acrobat会将其尺寸默认设置为100x100点。基于此特性，我们可以先添加一个临时图章，然后检查其尺寸，从而确定目标自定义图章是否存在，并据此决定是使用自定义图章还是标准图章。

在Adobe Acrobat中开发交互式PDF时，经常需要根据用户环境动态调整功能。其中一个常见需求是，在通过JavaScript代码插入自定义图章（Custom Stamp）之前，判断用户是否已安装该图章。如果图章不存在，直接插入会导致一个空白方块，影响用户体验。本文将深入探讨如何解决这一问题，确保即使自定义图章缺失，也能优雅地回退到标准图章。

问题背景与传统方法的局限性

开发者通常会创建带有特定动作的按钮，用于在预设位置插入自定义图章。然而，直接检查图章文件是否存在并非易事。在Adobe Acrobat JavaScript环境中，尤其是通过按钮触发的脚本，存在严格的安全沙箱限制。例如，尝试使用app.getPath('app','stamps')来获取用户图章文件夹路径，或使用app.openDoc来检查文件是否存在，通常会被安全策略阻止，导致脚本无法正常执行。

此外，即使尝试先添加一个图章，然后检查其属性来判断是否找到图像，也往往无法奏效。Acrobat在找不到图章图像时，并不会在图章对象的属性中明确指出图像缺失，而是简单地显示一个空白的占位符。

立即学习“Java免费学习笔记（深入）”；

Dora

创建令人惊叹的3D动画网站，无需编写一行代码。

547

查看详情

核心解决方案：利用图章尺寸的默认行为

Adobe论坛上的专家Try67提供了一个巧妙的解决方案：利用Adobe Acrobat在处理缺失图章时的默认行为。其核心思想是：

• 指定点而非矩形： 当使用this.addAnnot方法添加一个类型为"Stamp"的批注时，如果只指定一个点（例如rect: [x, y]），Acrobat会尝试以其原始尺寸应用图章。
• 缺失图章的默认尺寸： 如果指定了AP（Appearance Stream）但对应的图章不存在，Acrobat会默认创建一个尺寸为100x100点的空白图章。
• 判断依据： 因此，只要我们确保自定义图章的原始尺寸不是100x100点，就可以通过添加一个临时图章并检查其尺寸来判断目标自定义图章是否存在。

实现步骤与示例代码

基于上述原理，我们可以设计一个函数来检查图章的存在性。

1. 添加临时图章： 使用this.addAnnot方法，将AP设置为目标自定义图章的名称，并只指定一个点作为rect参数。
2. 获取图章尺寸： 获取刚刚添加的临时图章的rect属性，计算其宽度和高度。
3. 判断并移除： 如果宽度和高度都为100点，则说明自定义图章不存在。无论结果如何，都需要立即将这个临时图章移除，以避免对文档造成不必要的修改。
4. 应用最终图章： 根据判断结果，选择使用自定义图章的AP名称或标准图章的AP名称来添加最终的图章。

以下是具体的JavaScript代码实现：

// 定义目标自定义图章的AP名称
var customStampAP = "customDynStamp"; 
// 定义回退的标准图章AP名称
var defaultStampAP = "#DApproved"; 
// 假设自定义图章的原始尺寸不是100x100点

/**
 * 检查指定AP名称的自定义图章是否存在。
 * @param {string} apName 要检查的自定义图章的AP名称。
 * @returns {boolean} 如果自定义图章存在则返回 true，否则返回 false。
 */
function checkCustomStampExists(apName) {
    var exists = true;
    var tempAnnot = null;

    try {
        // 1. 添加一个临时图章，只指定一个点，让Acrobat根据AP名称决定尺寸
        // 注意：这里使用一个文档中不太可能被用户注意到的位置，且立即移除
        tempAnnot = this.addAnnot({
            page: 0, 
            type: "Stamp", 
            name: "TempStampCheck_" + apName, 
            rect: [0, 0] // 仅指定一个点，让其以原始尺寸应用
        });

        // 2. 尝试设置AP。如果AP不存在，Acrobat会创建一个100x100的空白图章
        tempAnnot.AP = apName;

        // 3. 获取临时图章的实际尺寸
        var rect = tempAnnot.rect;
        var width = rect[2] - rect[0];
        var height = rect[3] - rect[1];

        // 4. 判断尺寸。如果尺寸是100x100，则说明图章不存在
        if (width === 100 && height === 100) {
            exists = false;
        }

    } catch (e) {
        // 捕获任何可能的错误，例如AP名称无效等，通常这种情况下也视为不存在
        exists = false;
        console.println("Error checking stamp existence: " + e.toString());
    } finally {
        // 5. 无论如何，移除临时图章
        if (tempAnnot) {
            tempAnnot.destroy();
        }
    }
    return exists;
}

// 在实际应用中调用检查函数
var useThisAP;
if (checkCustomStampExists.call(this, customStampAP)) {
    useThisAP = customStampAP;
} else {
    useThisAP = defaultStampAP;
}

// 最终添加图章的逻辑
var annot = this.addAnnot({
    page: 0, 
    type: "Stamp", 
    name: "FinApproval",  
    rect: [356, 200, 453, 245], // 指定最终图章的位置和大小
    AP: useThisAP 
});

// 假设有一个名为 "Approval button" 的字段，在图章添加后隐藏
var f = getField("Approval button");
if (f) { // 检查字段是否存在以避免错误
    f.display = display.hidden;
}

注意事项

1. 自定义图章尺寸： 此方法的核心假设是您的自定义图章的原始尺寸不是100x100点。如果您的自定义图章恰好就是100x100点，那么此方法将无法区分它是否存在。在这种极端情况下，您可能需要考虑为您的自定义图章设定一个非100x100的默认尺寸，或者寻找其他更复杂的（但可能受限的）方法。
2. 临时图章的清理： 确保在finally块中调用tempAnnot.destroy()来移除临时图章，防止在文档中留下痕迹。
3. 页面选择： 在添加临时图章时，page: 0表示在第一页添加。这通常是安全的，因为临时图章会被立即移除。
4. 错误处理： 添加try...catch块可以捕获在图章操作过程中可能发生的异常，提高脚本的健壮性。
5. 上下文 (this)： 在按钮动作或文档级脚本中，this通常指向当前文档对象。在调用checkCustomStampExists时，使用checkCustomStampExists.call(this, customStampAP)可以确保函数内部的this正确指向文档对象。

总结

通过利用Adobe Acrobat在处理缺失图章时尺寸默认行为的特性，我们可以有效地在JavaScript中判断自定义图章是否存在。这种方法规避了传统文件系统检查的安全限制，提供了一个相对可靠且易于实现的解决方案，确保了即使自定义图章缺失，也能优雅地回退到标准图章，从而提升了PDF应用的健壮性和用户体验。

以上就是如何在Adobe Acrobat JavaScript中检测自定义图章是否存在的详细内容，更多请关注php中文网其它相关文章！