17370845950

本文探讨了在Adobe Acrobat JavaScript环境中，如何判断用户是否安装了特定的自定义图章，以避免在图章缺失时插入空白区域。通过利用this.addAnnot方法在图章外观流（AP）不存在时，将图章默认尺寸设置为100x100点的特性，我们可以通过创建临时图章并检查其尺寸来间接判断自定义图章的存在性，从而实现动态选择使用自定义图章或标准图章的逻辑。

在Adobe Acrobat中，当开发者希望通过JavaScript在文档中插入自定义图章时，常常面临一个挑战：如何确认用户环境中是否已安装该自定义图章。如果图章未安装，直接调用其外观流（AP）名称会导致插入一个空白方块，而非预期的图章，这会影响用户体验和文档的完整性。传统的路径检查方法（如app.getPath结合app.openDoc）在按钮脚本等特定上下文中往往受限或无法有效执行。

挑战：动态图章插入的可靠性问题

我们希望实现一个逻辑：如果用户安装了名为customDynStamp的自定义图章，则使用它；否则，回退到标准的#DApproved动态图章。原始设想的伪代码如下：

if (*AP "customDynStamp" exists in user folder*) {
    useThisAP = "customDynStamp";
} else {
    useThisAP = "#DApproved";
}

var annot = this.addAnnot({
    page: 0, type: "Stamp", name: "FinApproval",  rect: [356, 200, 453, 245],
    AP: useThisAP
});
var f = getField("Approval button");
f.display = display.hidden;

然而，关键在于如何实现*AP "customDynStamp" exists in user folder*这一条件判断。直接检查文件路径在按钮脚本中不可行，且通过创建图章后检查其属性也难以区分空白图章与实际图章。

解决方案：利用this.addAnnot的默认尺寸行为

Adobe Acrobat JavaScript API中的this.addAnnot方法在处理图章时有一个关键特性： 如果在使用this.addAnnot插入图章时，只指定了图章的插入点（即rect参数只包含两个坐标，或通过计算得出宽度/高度为0），并且指定的外观流（AP）名称对应的图章不存在，那么系统会默认创建一个尺寸为100x100点的图章。

反之，如果指定的AP存在，并且rect参数只指定了插入点，系统会以图章的原始尺寸进行插入。

这个特性为我们提供了一个间接判断自定义图章是否存在的方法：

1. 创建一个临时的、隐藏的图章，并尝试使用自定义图章的AP。
2. 检查这个临时图章的尺寸。
3. 如果尺寸是100x100点，则说明自定义图章不存在；否则，说明自定义图章存在。
4. 根据判断结果，决定实际要插入的图章AP，并删除临时图章。

实施步骤与示例代码

下面是结合上述原理的JavaScript代码实现：

// 定义自定义图章和备用图章的AP名称
var customStampAP = "customDynStamp";
var fallbackStampAP = "#DApproved";
var useThisAP = fallbackStampAP; // 默认使用备用图章

// 步骤1: 创建一个临时的、隐藏的图章来检查其尺寸
// 我们只指定一个点作为rect的起始，让系统决定其尺寸
// 注意：rect的四个坐标 [x1, y1, x2, y2] 即使 x1=x2, y1=y2 也表示一个点
// 为了确保它不可见且不影响文档，可以将其放置在页面外或设置为隐藏
var tempAnnot = this.addAnnot({
    page: 0, // 选择一个页面，例如第一页
    type: "Stamp",
    name: "TempStampCheck_" + Math.random().toString(36).substring(7), // 生成一个唯一的临时图章名称
    rect: [0, 0, 0, 0], // 理论上这会是一个点，让系统决定尺寸。实际操作中，为了确保是点，可以设置为 [x, y, x, y]
                        // 然而，如果AP不存在，系统会将其扩展为 [x, y, x+100, y+100]
    AP: customStampAP,
    hidden: true, // 确保图章不可见
    noPrint: true // 确保图章不会被打印
});

// 步骤2: 检查临时图章的尺寸
// 获取临时图章的宽度和高度
var tempWidth = tempAnnot.rect[2] - tempAnnot.rect[0];
var tempHeight = tempAnnot.rect[3] - tempAnnot.rect[1];

// 假设我们的自定义图章的原始尺寸不是精确的100x100点。
// 如果自定义图章存在，其尺寸将是其原始尺寸；如果不存在，将是100x100。
if (tempWidth !== 100 || tempHeight !== 100) {
    // 如果尺寸不是默认的100x100，则说明customStampAP存在且被成功使用
    useThisAP = customStampAP;
}

// 步骤3: 删除临时图章
this.deleteAnnot(tempAnnot);

// 步骤4: 使用确定的AP插入实际的图章
var finalAnnot = this.addAnnot({
    page: 0, // 插入图章的页面
    type: "Stamp",
    name: "FinApproval", // 最终图章的名称
    rect: [356, 200, 453, 245], // 最终图章的位置和尺寸
    AP: useThisAP
});

// 隐藏触发图章插入的按钮（如果适用）
var approvalButton = getField("Approval button");
if (approvalButton) {
    approvalButton.display = display.hidden;
}

注意事项

1. 自定义图章尺寸假设： 此方法的核心在于假设你的自定义图章的原始尺寸不是精确的100x100点。如果你的自定义图章恰好是100x100点，那么此检测方法将失效，因为其尺寸会与AP不存在时的默认尺寸混淆。在这种特殊情况下，你需要寻找其他默认尺寸（例如，尝试一个非常规的AP名称，看看它是否总是返回100x100，或者尝试更复杂的检测逻辑）。
2. 临时图章的管理： 确保临时图章被正确删除。虽然hidden: true和noPrint: true可以使其不干扰用户，但及时删除能保持文档整洁。
3. 页面选择： 在创建临时图章时，page: 0表示第一页。你可以根据实际需求选择一个不常用的页面或确保其在文档中不会引起注意。
4. 性能考量： 每次执行此脚本都会涉及创建和删除注释对象。对于单个按钮点击事件，这通常不是问题。但在需要频繁检查的复杂场景中，可能需要考虑优化，例如将检查结果缓存。

总结

通过巧妙地利用this.addAnnot方法在图章AP不存在时的默认尺寸行为，我们成功地绕过了直接文件路径检查的限制，实现了在Adobe Acrobat JavaScript环境中动态判断自定义图章是否存在的功能。这种方法提供了一种可靠的机制，确保在自定义图章缺失时，能够优雅地回退到备用方案，从而提升了PDF文档交互的健壮性和用户体验。