Campos do Formulário Dinâmico

Lista de Campos do Formulário Dinâmico

Os Campos do Formulário Dinâmico são usados para permitir que o usuário insira e visualize valores e são a base para a programação de um Formulário Dinâmico.

Configuração dos Campos

Página de propriedades que permite a alteração de configurações de um Campo

Na tela de modificação de campo, na página de propriedades, estão uma série de campos de configuração, que podem ser diferentes de acordo com o tipo do Campo. Por isso, é importante escolher o tipo antes de seguir para as outras especificações.

Tipo

Tipo de dados do Campo. Veja mais no tópico Tipos de Campos.

Aparência

Balão de Ajuda

• todos menos Gauge

Texto a ser exibido no Balão de Ajuda, que aparece quando o ponteiro do mouse fica sobre o campo.

Fonte

• label

Permite escolher vários parâmetros de fonte para o texto.

Cor de Fundo

• imageView

Cor de fundo da imagem.

Largura mínima

• botão

Largura mínima do botão em pixels.

Imagem

• botão

Imagem a ser exibida no botão. Pode ser usada uma imagem dos arquivos ou uma Font Awesome customizada.

Comportamento

Habilitado

• Todos os tipos de campo

Se estiver marcado, o campo estará habilitado para interação do usuário.

Visível

• Todos os tipos de campo

Se estiver marcado, o campo será exibido na tela, caso contrário, o campo não será exibido mas ainda assim poderá ser utilizado nos comandos SQL.

Preenchimento obrigatório

• NumericTextBox
• TextBox
• DateTimePicker
• ComboBox
• Lookup
• HTMLeditor
• RadioButton
• ColorPicker
• Upload
• consulta
• TreeView

O preenchimento do campo será obrigatório.

Somente Leitura

• TextBox
• NumericTextBox
• DateTimePicker
• ComboBox
• HTMLeditor

O campo estará habilitado somente no modo de leitura.

Valor mínimo

• NumericTextBox
• Gauge

Valor mínimo que o usuário pode inserir.

Valor máximo

• NumericTextBox
• Gauge

Valor máximo que o usuário pode inserir.

Cancelar submissão

• NumericTextBox
• TextBox
• DateTimePicker
• Lookup

Desabilita a submissão de dados do formulário ao pressionar ENTER sobre o campo.

Habilitar correção ortográfica

• TextBox
• Label

Quando habilitado, a ortografia do texto será verificada pelo navegador.

Texto para campo vazio

• NumericTextBox
• TextBox
• DateTimePicker
• ComboBox
• Lookup
• HTMLeditor
• TreeView

Texto esmaecido que aparecerá dentro do campo antes do mesmo ser preenchido.

Habilitar Borda

• ImageView
• HTMLElement

Uma borda será desenhada ao redor da imagem.

Quantidade de casas decimais

• NumericTextBox

Quantidade de casas decimais a serem utilizadas no preenchimento do campo.

Máscara

• TextBox

Informe a máscara a ser utilizada no controle. Use # para representar dígitos e L para representar caracteres.

Multilinha

• TextBox

Permite o uso de quebra de linha.

Expressão Regular

• TextBox

Informe uma expressão regular para validar o texto informado no campo.

Comprimento Máximo

• TextBox

Comprimento máximo do texto em caracteres.

Transformação de Texto

• TextBox

Selecione uma opção de transformação de texto. O texto será transformado durante a digitação do campo.

Mostrar Linhas

• TreeView

Mostrar linhas pontilhadas entre os nós da TreeView.

Expandido

• TreeView

Ao carregar a TreeView, todo seu conteúdo será apresentado expandido.

Disposição da Imagem

• ImageView

Indica o modo no qual a imagem será exibida dentro do campo.

Receber dados no servidor

• HTMLElement

O conteúdo HTML desse campo será enviado de navegador para o servidor ao processar um evento. Caso contrário, o valor do campo no servidor será sempre NULL.

mostrar cores recentes

• ColorPicker

Exibir as últimas cores utilizadas abaixo da paleta.

permitir cores personalizadas

• ColorPicker

Exibir um seletor de cores personalizadas.

Alinhamento

• Label

Alinhamento do texto.

Conteúdo Editável

• Label

Será possível alterar o texto do campo.

Habilitar Editor

• Lookup

Habilita ou desabilita o editor do Lookup. Se estiver desabilitado, o usuário não poderá informar valores manualmente. Neste caso, será necessário que ele selecione um registro clicando no botão de seleção.

Extensões Permitidas

• Upload

Informe as extensões permitidas, separadas por vírgulas, (jpg, png, gif). Se este campo estiver em branco, todas as extensões serão permitidas. Obs.: Este campo será utilizado quando o valor Tipo de Arquivo for Todos.

Tipo de Arquivo

• Upload

Selecione um tipo de arquivo pré-definido ou selecione a opção Todos para especificar as extensões permitidas.

Tamanho Máximo

• Upload

Informe o tamanho máximo do arquivo em KBytes. Obs.: 1MB é igual a 1024 KB.

Quantidade Mínima de Arquivos =

• Upload

Informe a quantidade mínima de arquivos que o usuário deve selecionar.

Quantidade Máxima de Arquivos

• Upload

Informe a quantidade máxima de arquivos que o usuário deve selecionar.

Destino

• Upload

Informe os dados de configuração de destino do arquivo. Pode ser Diretório do Servidor ou FTP e o nome da pasta pode conter marcações no formato (INPUT campo) que serão substituídas pelo valor correspondente.

Nome do arquivo

• Upload

Determine a composição do nome do arquivo salvo no servidor.

Requer Validação de Campos

• Button

O sistema irá validar o preenchimento dos campos da tela do navegador andes do evento 'Click' ser processado.

Tipo de Botão

• Button

Somente se for selecionada a opção 'submit' será executada no site a ação de envio(Submit).

Alvo

• Link

Define aonde a página será aberta.

Dados

Coluna de origem

• all

Seleciona a coluna da fonte de dados do formulário. Este campo é utulizado para fazer o vínculo entre a query de origem e os campos da tela. Quando a página for aberta, a query será executada e vai preencher o campo com o valor da coluna selecionada.

Alvo

• lookups

Selecione e configure o Browse Dinâmico que será aberto para procurar os dados na tela (ícone de lupa ao lado do campo).

Itens

• combobox

Informe os itens do campo. Para cada item é necessário especificar o valor e o texto a ser exibido.

Fonte de Dados

• combobox
• treeview

Informe o comando SQL que será usado para carregar os itens da lista. Se o comando retornar apenas uma coluna, ela será usada como texto de exibição e valor da opção. Se retornar duas colunas, a primeira será usada para o valor e a segunda para o texto de exibição. As demais colunas retornadas serão ignoradas.

Extrator de Arquivos

• ImageView

Selecione o extrator de arquivos que será utilizado para extrair os arquivos do banco de dados.

Carregar sob Demanda

• treeview

Indica que os dados da treeview serão carregados sob-demanda, ou seja, os nós filhos só serão carregados quando o usuário expandir o nó pai.

Identificação

Nome

Nome do Campo. É um campo chave, usado para identificar o Campo dentro do sistema. Ele deve ser único dentro da Consulta. É permitida apenas a entrada de letras sem acentuação, números e o caractere "_" (underline).

Descrição

Descrição do Campo. É o texto que será exibido no LATROMI Web para apresentar ao usuário. Se não for preenchido, o sistema usará o nome do Campo.

Layout

Largura

• all

Largura do campo em pixels.

Altura

• query
• imageView

Altura do campo em pixels.

Valor Padrão

Tipo de Valor Padrão

• txt
• ntb
• dateTimePicker
• combobox
• TreeView

Indica o tipo de valor padrão a ser utilizado no preenchimento inicial do campo.

Valor Fixo

• txt
• ntb
• dateTimePicker
• combobox
• CheckBox
• RadioButton
• TreeView
• Gauge

Valor fixo utilizado no prenchimento do campo, caso o Tipo de valor padrão seja Valor Fixo.

Data Fixa

• dateTimePicker

Data a ser utilizada no prenchimento do campo, caso o Tipo de valor padrão seja Data Fixa.

Quantidade a Somar ou Subtrair

• dateTimePicker

Indica a quantidade de dias/meses/anos a serem somados ou subtraídos do valor padrão adotado para o campo. Para subtrair, informe valores negativos.

Tipo de Período da Operação

• dateTimePicker

Indica o tipo de período a ser utilizado na operação de soma ou subtração.

Texto

• Label

Texto utilizado no preenchimento do campo.

Endereço Padrão

• link

Texto fixo utilizado como endereço de navegação padrão.

Configurações de Imagens

• Upload

Gerar Miniatura

Se esta opção estiver habilitada e as dimensões da miniatura estiverem devidamente preenchidas, será gerado um arquivo de miniatura adicional, cujo nome será <NOME_DO_ARQUIVO_ORIGINAL>.thumb.<EXT>

Tamanho da Miniatura

Dimensões da miniatura da imagem. Estas são as medidas máximas de cada dimensão da imagem, não sendo necessário o preenchimento das duas. Se for necessário redimensionar a imagem, será feito mantendo as proporções originais.

Redimensionar imagem

Se esta opção estiver habilitada e as dimensões máximas da imagem estiverem devidamente preenchidas, a imagem será redimensionada durante o Upload.

Tamanho Máximo

Medidas máximas de cada dimensão da imagem, não sendo necessário o preenchimento das duas. Se for necessário redimensionar a imagem, será feito mantendo as proporções originais.

Mobile

• Upload

Captura de Imagem direto da câmera

Se esta opção estiver habilitada enquanto o formulário é acessado através de um dispositivo mobile, a câmera do dispositivo será invocada automaticamente ao clicar no campo.

Tipos de Campos

Existem Campos com diferentes tipos de dados e apresentação. Abaixo, estão descritos cada um deles:

Tipo	Prefixo	Descrição
Numeric Text Box	ntb / num	Números Racionais
Text Box	txt	Sequências de caracteres
Date/Time Picker	dtp	Selecionador de data a partir de um calendário
Combo Box	cbo	Mostra os resultados em uma lista no estilo Combo box
Lookup	lkp
Check Box	chk	Manipulação de Sim ou Não com marcação visual
Radio Button	rbt
Color Picker	clp	Escolha de cor
Label	lbl
Upload	upl
HTML Editor	htm	Editor de HTML
Consulta	qry	Uma consulta do LATROMI dentro do formulário dinâmico
Button	btn	Botão sem estados
Link	lnk	Link
Treeview	trv
ImageView	img
HTML Element	div / elm	Elemento HTML
Guage	gau

Eventos

Página de eventos do campo

Os Eventos são a base da programação de um Formulário Dinâmico e pertencem aos campos. Para cada tipo de campo, existem Eventos específicos que disparam os Procedimentos a eles vinculados em situações diferentes. Este tópico está detalhado em Programação.

Aba Campos

Opção de criação automática de Campos

Quando você clicar pela primeira vez na aba Campos, será perguntado se deseja adicionar automaticamente os campos conforme a sua consulta SQL informada no item Fonte de Dados. Se isso for escolhido, será criado um Campo para cada coluna no retorno da query, sem prefixos porém com tipo automaticamente detectado. Ainda será possível excluir, modificar e adicionar Campos à lista. Caso seja necessário adicionar novos campos e ou botões, siga a tabela acima para saber qual prefixo utilizar antes do nome. Ex: btnConfirmar para adicionar um botão de Confirmar para o seu formulário.

Ver Também

• Visão Geral do Formulário Dinâmico