field

O objeto field descreve um contêiner interativo único capaz de capturar e apresentar conteúdo de dados.

Em termos de objetos disponíveis na Biblioteca de objetos do Designer, o objeto de campo é a definição básica do XML para os seguintes objetos:

  • Códigos de barras

  • Botão

  • Campo de data/hora

  • Campo decimal

  • Campo de assinatura

  • Botão Submeter por email

  • Botão Submeter por HTTP

  • Campo de imagem

  • Campo numérico

  • Código de barras para formulários impressos

  • Campo de senha

  • Botão Imprimir

  • Botão Redefinir

  • Campo de texto

Você pode definir mensagens de validação personalizadas. Um único campo pode conter até três mensagens, uma para cada teste de script, teste de imagem e teste nulo. Quando especificadas, essas mensagens podem ser acessadas com a sintaxe a seguir:

field.validate.message.scriptTest.value 
field.validate.message.formatTest.value 
field.validate.message.nullTest.value

Também é possível acessar essas mensagens de validação com suas propriedades de atalho:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Quando esses valores não estão preenchidos, o processador constrói uma mensagem padrão.

Um campo pode ter o máximo de um teste de validação em estado de falha em qualquer momento determinado. Os testes de validação são avaliados na ordem a seguir e a avaliação para no primeiro teste que falha:

  1. nullTest

  2. formatTest

  3. scriptTest

Hierarquia de objetos

Modelo

Objetos filho

Modelo de formulário

assist

bind

border

calculate

caption

connect

desc

extras

font

format

items

keep

margin

para

traversal

ui

validate

value

Classe pai

classe container

Propriedades

Nome

Descrição

Tipo

Acesso

{default}

Representa o valor real armazenado por um objeto.

Varia

Leitura/gravação

access

Controla o acesso do usuário ao conteúdo de um objeto de contêiner, como um subformulário.

String

Leitura/gravação

accessKey

Especifica uma tecla aceleradora usada por um aplicativo interativo para mover o foco de entrada para um elemento de campo específico.

String

Leitura/gravação

anchorType

Especifica a localização do ponto de ancoragem do contêiner quando colocado usando-se uma estratégia de layout posicionado.

String

Leitura/gravação

borderColor

Especifica o valor de cor da borda desse campo.

String

Leitura/gravação

borderWidth

Especifica a largura da borda desse campo.

String

Leitura/gravação

colSpan

Especifica o número de colunas expandidas por esse objeto quando usado dentro de um subformulário com um tipo de layout de linha.

String

Leitura/gravação

editValue

Especifica o valor de edição do campo.

String

Leitura/gravação

errorText

Retorna a mensagem de validação do primeiro teste de validação falho ou uma string vazia, se esse campo tiver passado por todos os testes de validação.

String

Leitura

fillColor

O valor de cor de plano de fundo desse campo.

String

Leitura/gravação

fontColor

Especifica o valor de cor de primeiro plano do campo. É o equivalente de font.fill.color.valueexpression.

String

Leitura/gravação

formatMessage

Especifica a string da mensagem de validação de formato para esse campo.

String

Leitura/gravação

formattedValue

Especifica o valor formatado para o campo.

String

Leitura/gravação

h

Uma medida da altura para o layout.

String

Leitura/gravação

hAlign

Especifica o alinhamento de texto horizontal.

String

Leitura/gravação

length

Especifica o número de objetos da lista.

Inteiro

Leitura

locale

Especifica o idioma, a moeda e a formatação de data/hora a serem usados para o conteúdo do objeto.

String

Leitura/gravação

mandatory

Especifica o valor de nullTest do campo.

String

Leitura/gravação

mandatoryMessage

Especifica a string da mensagem obrigatória para esse campo.

String

Leitura/gravação

maxH

Especifica a altura máxima para finalidades de layout.

String

Leitura/gravação

maxW

Especifica a largura máxima para finalidades de layout.

String

Leitura/gravação

minH

Especifica a altura mínima para finalidades de layout.

String

Leitura/gravação

minW

Especifica a largura mínima para finalidades de layout.

String

Leitura/gravação

parentSubform

Especifica o subformulário pai (página) desse campo.

Objeto

Leitura

presence

Especifica a visibilidade de um objeto.

String

Leitura/gravação

rawValue

Especifica o valor não formatado do objeto atual.

Varia

Leitura/gravação

relevant

Controla se um objeto de formulário é incluído quando o formulário é impresso.

String

Leitura/gravação

rotate

Gira o objeto ao redor do seu ponto de ancoragem de acordo com o ângulo especificado.

String

Leitura/gravação

selectedIndex

O índice do primeiro item selecionado.

Inteiro

Leitura/gravação

use

Chama um protótipo.

String

Leitura/gravação

usehref

Chama um protótipo externo.

String

Leitura/gravação

validationMessage

Especifica a string da mensagem de validação para esse campo.

String

Leitura/gravação

vAlign

Especifica o alinhamento de texto vertical.

String

Leitura/gravação

w

Uma medida que especifica a largura para o layout.

String

Leitura/gravação

x

Especifica a coordenada X do ponto de ancoragem do contêiner em relação ao canto superior esquerdo do contêiner pai quando posicionado com o layout posicionado.

String

Leitura/gravação

y

Especifica a coordenada Y do ponto de ancoragem do contêiner em relação ao canto superior esquerdo do contêiner pai quando posicionado com o layout posicionado.

String

Leitura/gravação

Métodos

Nome

Descrição

Retorna

addItem

Adiciona novos itens ao campo de formulário atual. Por exemplo, esse método adiciona novos itens a uma lista suspensa.

Vazio

boundItem

Obtém o valor vinculado de um item de exibição específico de uma lista suspensa ou caixa de listagem.

String

clearItems

Remove todos os itens do campo. Por exemplo, remove todos os itens contidos em uma lista suspensa ou em uma caixa de listagem.

Vazio

deleteItem

Exclui o item especificado.

Booliano

execCalculate

Executa qualquer script no evento calculate do objeto especificado, e qualquer objeto filho.

Vazio

execEvent

Executa o script de evento do objeto.

Vazio

execInitialize

Executa qualquer script no evento initialize do objeto especificado, e qualquer objeto filho.

Vazio

execValidate

Executa qualquer script no evento validate do objeto especificado, e qualquer objeto filho.

Vazio

getDisplayItem

Recupera o texto de exibição do item para o índice de itens especificado.

String

getItemState

Retorna o estado da seleção do item especificado.

Booliano

getSaveItem

Recupera o valor de dados para o índice de itens especificado.

String

setItemState

Define o estado da seleção do item especificado.

Vazio

setItems

Adiciona novos itens e valores ao campo de formulário atual. Por exemplo, esse método adiciona novos itens e valores como argumentos em uma lista suspensa.

Vazio