Referência a objetos em cálculos e scripts

Embora os cálculos FormCalc e os scripts JavaScript tenham regras para estruturar códigos, ambos confiam na mesma sintaxe de referência ao acessar propriedades e valores de objeto de formulário. O Modelo de objeto de formulário XML fornece uma maneira estruturada para acessar propriedades e valores de objetos por meio de uma convenção de nomeação composta com cada objeto, propriedade e método separados por caracteres de pontos (.).

Em geral, cada sintaxe de referência tem uma estrutura similar dividida nas seguintes seções:

  • Os nomes dos objetos pai na hierarquia do formulário usada para navegar até um campo ou objeto específico. Use a paleta Hierarquia e a paleta Exibição de dados para determinar o local de um objeto em relação a outros objetos do formulário e de qualquer dado relacionado.

  • O nome do objeto ao qual você deseja fazer referência.

  • O nome da propriedade ou do método que você deseja acessar. Essa seção também pode incluir objetos do Modelo de objeto de formulário XML que antecedem a propriedade ou o método na estrutura, mas que não aprecem como objetos na paleta Hierarquia.

Por exemplo, a ilustração a seguir mostra a sintaxe de referência para acessar o valor de um campo de texto em um design de formulário que usa as convenções padrão de nomeação de objetos:

A.
Objetos da hierarquia de formulários

B.
Nome do objeto

C.
Nome da propriedade ou do método

Nota: Por padrão, o objeto de subformulário que representa a primeira página de um novo formulário não é nomeado. Na sintaxe de referência acima, o subformulário não nomeado é representado por #subform.

A estrutura de notação da sintaxe de referência varia ligeiramente de acordo com a situação específica. Por exemplo, uma sintaxe de referência completa funciona em qualquer situação; no entanto, em alguns casos, é possível usar uma sintaxe de referência reduzida ou um atalho de sintaxe para diminuir o tamanho da sintaxe.