Uso de campos numéricos e decimais

Campos decimais são muito semelhantes a campos numéricos. A tabela a seguir descreve as diferenças entre os campos decimais e numéricos.

Campo

Descrição

Campo decimal

Exibe números em formato decimal.

É possível definir o número máximo de dígitos à esquerda e à direita.

É possível definir um padrão de exibição para restringir o valor formatado com os dígitos à esquerda e à direita.

Não é possível especificar um formato de dados para um campo decimal, ele é sempre armazenado como decimal.

Por padrão, o valor formatado inclui dois dígitos depois do caractere de radix.

Campos numéricos

Exibe números em flutuante ou inteiro.

Não é possível definir o número máximo de dígitos à esquerda e à direita.

É possível definir um padrão de dados e um formato de dados (flutuante ou inteiro).

O valor formatado inclui apenas dois dígitos depois do caractere de radix.

Use o campo decimal nos seguintes casos:

  • Se quiser definir o número de dígitos à esquerda ou à direita

  • Se quiser que a precisão dos dados decimais ou inteiros seja mostrada exatamente como esses dados foram digitados (garantindo que a opção Limitar dígitos de rastreamento esteja desmarcada) sem truncar

Por exemplo, um campo Qtd. está localizado em um subformulário repetitivo. Na primeira ocorrência do subformulário, esse campo pode incluir o valor 3 e, na segunda, o valor 3,123:

  • Se a opção Limitar dígitos de rastreamento for definida para um máximo de 2, o primeiro número é armazenado como 3 (já que os zeros à direita serão removidos), e o segundo número é armazenado como 3,12 (pois o número é truncado).

  • Se a opção Limitar dígitos de rastreamento for desmarcada, os 2 números são armazenados exatamente como são digitados (o primeiro número é armazenado como 3 e o segundo número é armazenado como 3,123).

Para saber mais sobre as opções para campos decimais, consulte a seção sobre campos numéricos, pois muitas das opções são idênticas.

Nota: Para usar o objeto de campo decimal em um formulário interativo, é necessário ter o Adobe Reader 6.0.3 ou posterior.

Sobre campos numéricos

Se você quiser oferecer suporte à coleta ou à exibição de dados flutuantes ou inteiros, incluindo moedas, adicione um campo numérico ao formulário. O valor em um campo numérico pode ser formatado e exibido de acordo com padrões predefinidos e de acordo com a localidade especificada para o campo.

Após adicionar um campo numérico ao design do formulário, é possível editar o texto da legenda e manipular as propriedades do objeto nas guias Campo, Valor e Vínculo da paleta Objeto. As seguintes propriedades podem ser definidas:

  • Altere a legenda do campo. Consulte Formatação de legendas.

  • Definir um estilo de borda do campo. Consulte Definição do estilo da borda.

  • Definir o campo como visível, invisível ou oculto. Consulte Tornar os objetos visíveis, invisíveis ou ocultos.

  • Especificar uma localidade para o campo. Consulte Especificação de uma localidade (idioma e país ou região) para um objeto.

  • Especificar o formato de combinação para o campo. Consulte Uso de campos de texto.

  • Especifique se o Designer usa o comprimento horizontal do campo de texto para determinar quantos números são permitidos.

  • Definir o padrão de exibição.

  • Definir o padrão de edição.

  • Especificar um valor inicial a ser exibido.

  • Definir uma propriedade de tempo de execução (por exemplo, inserir o número de uma página renderizada).

  • Definir o padrão de validação.

  • Escolher se o campo oferecerá suporte para valores de ponto flutuante ou inteiros.

  • Especificar um padrão de vínculo de dados.

  • Especificar um método de vínculo para o armazenamento e a recuperação dos dados vinculados.

Campos numéricos oferecem suporte para scripts e cálculos. Se um usuário tiver que fornecer dados, será possível definir se a sua entrada é recomendada ou obrigatória e configurar mensagens para avisar os usuários adequadamente. Todas as entradas de usuários podem ser validadas por meio de scripts.

Nota: Campos numéricos apresentam um valor máximo, calculado ou digitado pelo usuário, igual a 2.147.483.647, que corresponde ao maior número compatível com um número inteiro assinado em 32 bits de um computador.

Definição de um alinhamento de radix (ponto decimal) para valores numéricos.

  1. No menu da paleta Parágrafo, selecione Editar valor.

  2. Clique em Alinhamento do radix .

  3. Na caixa adjacente, digite a quantidade de espaço a ser criada entre o ponto de radix e a extremidade direita da área de preenchimento.

  4. Pressione Enter.

    Importante: O Acrobat 6.0.2 e Adobe Reader 6.0.2 não oferecem suporte à definição do alinhamento do radix. Para salvar o design como um formulário PDF compatível com o Acrobat 6.0.2, não use o alinhamento do radix. Se o fizer, os usuários não poderão editar os valores.

Definição do comportamento dos campos decimais ou numéricos

  1. Na paleta Objeto, clique na guia Valor e selecione uma destas opções na lista Tipo:

    • Para permitir que os usuários escolham se desejam os dados, selecione Usuário inserido - opcional.

    • Para solicitar que os usuários insiram e tornem o campo recomendado, selecione Usuário inserido - recomendado e digite uma mensagem personalizada na caixa Mensagem vazia.

    • Para solicitar que os usuários insiram e tornem o campo requerido, selecione Usuário inserido - requerido e digite uma mensagem personalizada na caixa Mensagem vazia.

    • Para tornar o campo somente leitura e exibir um valor de dado que seja calculado e exibido através de um script anexado, selecione Calculado - somente leitura. Os usuários não podem editar o valor calculado.

    • Para tornar o campo editável e exibir um valor de dado que seja calculado e exibido através de um script anexado, selecione Calculado - o usuário pode substituir. Os usuários poderão editar o valor se o script de cálculo tiver sido gravado para aceitar a entrada. Se um usuário editar o valor calculado, será exibida a mensagem personalizada que foi especificada na caixa Suprimir mensagem.

    • Para tornar o campo somente leitura e exibir um valor de dado que seja mesclado ou calculado e exibido em tempo de execução, selecione Somente leitura. Os usuários não podem editar o valor.

  2. Se o valor for recomendado ou obrigatório, digite um prompt na caixa Mensagem vazia.

  3. Se o valor será calculado, anexe o script de cálculo ao objeto usando o Editor de scripts.

  4. (Opcional) Se um valor calculado puder ser substituído, digite uma mensagem na caixa Suprimir mensagem.

Definição de propriedades personalizadas de vínculo de dados para campos decimais ou numéricos

As opções de vínculo permitem criar um formulário que capture dados para infraestruturas empresariais e/ou usar uma fonte externa de dados para preencher um formulário em tempo de execução. Defina propriedades de vínculo de dados na guia Vínculo da paleta Objeto.

  1. Selecione o campo.

  2. Permita que o formulário seja conectado a uma fonte de dados no momento em que for aberto.

  3. Vincule o campo aos nós de dados correspondentes. Para obter informações sobre como vincular objetos a uma fonte de dados, consulte Vínculo de campos a uma fonte de dados.

Especificação do formato de dados para campos numéricos

Campos numéricos podem salvar dados no formato Flutuante ou Inteiro. O padrão é Flutuante.

Por padrão, dados numéricos em um Campo decimal salva apenas um máximo de dois dígitos após a casa decimal. Dados além da segunda casa decimal são arredondados.

  1. Na paleta Objeto, clique na guia Vínculo.

  2. Selecione o formato apropriado na lista de Formato de dados:

    • Para especificar o formato do número como uma representação em três partes de um número que contém um caractere de radix, selecione Flutuante.

    • Para especificar o número como qualquer sequência de dígitos de 0 a 9, possivelmente precedido de um sinal de menos, selecione Inteiro.

Limite dos números inseridos nos campos decimais e numéricos

É possível limitar quantos números poderão ser inseridos nos campos numéricos e decimais, especificando se o Designer usará o comprimento horizontal do campo decimal ou numérico para determinar quantos números serão permitidos.

 Na paleta Objeto, clique na guia Campo e selecione a opção Limitar comprimento à área visível.

Execução de um cálculo com campos decimais usando JavaScript

É possível executar cálculos com campos decimais usando FormCalc. No entanto, se a opção Limitar dígitos de rastreamento não estiver selecionada, e você quiser usar JavaScript para executar um cálculo com campos decimais, será necessário usar um script. Para manter um alto grau de precisão, o Designer armazena o valor dos campos decimais como uma string. O script indica para o campo decimal que ele é um número.

Por exemplo, você tem três campos decimais no design de formulário. O primeiro é nomeado a, o segundo b e o terceiro Total. Você deseja executar um cálculo que adiciona a e b.

  1. Se o Editor de scripts ainda não estiver visível, selecione Janela > Editor de scripts.

  2. (Opcional) Arraste a barra da paleta Editor de scripts até que a paleta fique maior.

  3. Selecione o campo decimal que deseja usar em um cálculo.

  4. Selecione Calculate na lista Exibir, JavaScript na lista Idioma e Cliente na lista Executar em.

  5. No campo Fonte script, digite o seguinte script:

    Total.rawValue = Number(a.rawValue) + Number (b.rawValue)
    • Total é o nome do campo decimal que deseja usar em um cálculo.

    • a é o primeiro campo decimal.

    • b é o segundo campo decimal.

  6. Exiba o formulário na guia Visualizar PDF.

Especificação do formato de combinação para campos numéricos e decimais

Use o formato de combinação quando desejar separar os caracteres e os números adicionados aos campos decimais e numéricos por linhas de borda.

  1. Na paleta Objeto, clique na guia Campo.

  2. Selecione Combinação de caracteres para incluir linhas de borda que separam cada número dentro do campo decimal ou do campo numérico.

  3. Digite quantos números serão separados por linhas de borda dentro do campo decimal ou do campo numérico.