|
O objeto de script pode ser usado para armazenar funções e valores JavaScript separadamente de qualquer objeto de formulário específico. Em geral, esse objeto é usado de forma a criar funções e métodos personalizados para uso como parte de scripts JavaScripts em vários locais de um formulário. Essa técnica reduz a quantidade geral de scripts necessários para realizar ações repetitivas.
O objeto de script suporta apenas scripts escritos em JavaScript; contudo, não há restrições sobre o local onde os scripts são executados, desde que a linguagem de script do evento que chama o objeto de script seja definida como JavaScript.
O Acrobat e o Forms processam scripts a partir de um objeto de script da mesma maneira, mas ambos também são distintos.
Apenas os scripts definidos para execução no cliente podem usar objetos de script definidos para execução no cliente, e vice-versa.
Criação de objeto de scriptA criação do objeto de script divide-se em duas partes. A primeira envolve o acréscimo do próprio objeto ao design de formulário e a segunda consiste na gravação do script a ser armazenado no objeto.
Crie um novo formulário ou abra um formulário existente.
Na paleta Hierarquia, clique com o botão direito do mouse em um objeto em nível de formulário ou em um objeto em nível de subformulário e selecione Inserir objeto de script.
Visualizar gráfico inteiro A. Objeto no nível de formulário B. Objeto no nível de subformulário C. Objeto de script no nível de subformulário D. Objeto de script de nível de formulário (Opcional) Clique com o botão direito do mouse no objeto de script e selecione Renomear objeto.
Adição de script a um objeto de scriptApós a inclusão de um objeto de script no formulário, é possível adicionar scripts usando o Editor de scripts.
Selecione o objeto de script na paleta Hierarquia.
O Editor de scripts é exibido com um valor de Objeto de script na lista Exibir e com um valor de JavaScript na lista Linguagem. Não é possível alterar esses valores.
Digite o script no campo Origem do script.
Clique na guia Visualizar PDF para testar o formulário.
ExemploPor exemplo, crie um objeto de script denominado feedback, que contenha a seguinte função:
function emptyCheck(oField) {
if ((oField.rawValue == null) || (oField.rawValue == "")) {
xfa.host.messageBox("You must input a value for this field.", "Error Message", 3);
}
}
Para fazer referência a funções JavaScript armazenadas em um objeto de scriptApós adicionar scripts a um objeto de script, faça referência ao objeto de script de qualquer evento que ofereça suporte a scripts JavaScript.
Selecione um objeto no formulário e selecione um evento na lista Exibir.
Crie uma referência ao objeto de script e a qualquer função dentro do objeto de script. A sintaxe genérica a seguir supõe que o objeto no qual o objeto de script está sendo mencionado encontra-se no mesmo nível do objeto de script da hierarquia de formulário, ou que o objeto de script existe no mais alto nível da hierarquia de formulários.
script_object.function_name(parameter1, ...);
Aplique o novo script ao objeto de formulário e teste-o para visualizar o formulário usando a guia Visualizar PDF.
Semelhantemente a referenciar outros objetos em um formulário, é necessário fornecer uma sintaxe válida ao referenciar um objeto de script que inclua o local onde ele existe na hierarquia de formulário. Para obter mais informações sobre como fazer referência a objetos em script, consulte Referência a valores e propriedades do objeto.
ExemploPor exemplo, usando o exemplo de objeto de script de Adição de script a um objeto de script, coloque o script de JavaScript a seguir no evento exit de um campo de texto. Teste o formulário na guia Visualizar PDF.
|
|
|
