Uso de objetos JavaScript do Acrobat no Designer

No Designer, é possível executar scripts de alguns objetos JavaScript no Acrobat usando a sintaxe de script do Acrobat. Como resultado, é possível usar as propriedades e os métodos desses objetos em formulários. Por exemplo, para exibir uma mensagem no JavaScript Console a partir do Acrobat, adicione o seguinte script ao evento de objeto de design de formulário no Designer:

    console.println("Esta mensagem aparece no JavaScript Console".);

Também é possível fazer com que o formulário seja enviado por email adicionando o seguinte script ao evento click de um botão:

    var myDoc = event.target; 
    myDoc.mailDoc(true);
Nota: No Designer, é necessário que a linguagem de scripts do evento esteja definida como JavaScript para que o script seja executado corretamente em tempo de execução.

Também é possível usar referências aos objetos JavaScript do Acrobat na sintaxe de referência. Por exemplo, o script a seguir obtém o estado assinado de um campo de assinatura e executa uma ação com base nesse estado:

    // Proceed if the current field is not signed. 
    var oState = 
        event.target.getField("form1[0].#subform[0].SignatureField1[0]") 
            .signatureValidate(); //Get the field's signed state. 
 
if (oState == 0) { 
... 
}
Nota: Este exemplo usa uma sintaxe de referência totalmente qualificada para referenciar o texto. Para obter mais informações sobre como fazer referência aos objetos do design de formulário, consulte Referência a valores e propriedades do objeto.

Ao trabalhar com o JavaScript do Acrobat no Designer, lembre-se dos seguintes pontos:

  • No Designer, use event.target para acessar o objeto JavaScript Doc do Acrobat. No Acrobat, o objeto this é usado para fazer referência ao objeto Doc; no entanto, no Designer, o objeto this faz referência ao objeto do design de formulário ao qual o script está anexado.

  • O Editor de scripts não tem nenhuma conclusão de declaração para objetos JavaScript do Acrobat. Consulte a seção sobre JavaScript para referência de API do Acrobat.

  • O método Doc event.target.importTextData("file.txt") não é suportado para formulários XFA dinâmicos que foram certificados.

    Para obter mais informações sobre a conversão de scripts Acrobat para o Designer, consulte o artigo Converting Acrobat JavaScript for Use in Designer Forms (Conversão de JavaScript Acrobat para uso em formulários Designer) no Developer Center.