Programação
A programação de um Formulário Dinâmico é baseada em Eventos. Atribui-se uma série de instruções para cada evento que são disparadas quando estes acontecem.
Índice
- 1 Eventos
- 1.1 Load
- 1.2 Closing
- 1.3 Eventos de Campos
- 1.3.1 LostFocus
- 1.3.2 Click
- 1.3.3 CheckedChanged
- 1.3.4 SelectedItemChanged
- 1.3.5 PopUpItemSelected
- 1.3.6 FileUpload
- 1.3.7 FilesUploaded
- 1.3.8 FileUploadedRemoving
- 1.3.9 CommandExecuted
- 1.3.10 DownloadStarted
- 1.3.11 Rebinded
- 1.3.12 RowSelected
- 1.3.13 WindowOpened
- 1.3.14 NodeSelected
- 1.3.15 LastNodeSelected
- 2 Procedimentos
- 3 Funções
- 4 Editando uma lista de Instruções
- 5 Declaração de Controle
- 6 Ação
- 7 Comentários
- 8 Ver Também
Eventos
Os eventos acontecem durante o uso no Latromi WEB.
Load
Quando o Formulário for carregado na tela.
Closing
Quando um comando de fechar o formulário for ativado ou quando o formulário for fechado pelo usuário se ele fechar a janela no botão de fechar (X). Cancelável significa que pode ser cancelado por um um comando de cancelamento dentro de um procedimento nesse evento, não deixando a tela ser fechada pelo usuário.
Eventos de Campos
LostFocus
Dispara quando o foco sair desse campo quando o usuário estiver usando o formulário no Latromi Web. Existe nos campos de tipo: NumericTextBox, TextBox, DateTImePicker, LookUp.
Click
Dispara quando o usuário clica no botão. Exclusivo dos campos do tipo botão.
CheckedChanged
Dispara quando o valor for alterado. Existe nos campos de tipo: CheckBox, Consulta.
SelectedItemChanged
Dispara quando o valor selecionado for alterado. Existe nos campos de tipo: Combobox, LookUp, RadioButton.
PopUpItemSelected
explain Exclusivo dos campos do tipo LookUp.
FileUpload
explain Exclusivo dos campos do tipo Upload.
FilesUploaded
explain Exclusivo dos campos do tipo Upload.
FileUploadedRemoving
explain Exclusivo dos campos do tipo Upload.
CommandExecuted
explain Exclusivo dos campos do tipo Consulta.
DownloadStarted
explain Exclusivo dos campos do tipo Consulta.
Rebinded
explain Exclusivo dos campos do tipo Consulta.
RowSelected
explain Exclusivo dos campos do tipo Consulta.
WindowOpened
explain Exclusivo dos campos do tipo Consulta.
NodeSelected
explain Exclusivo dos campos do tipo TreeView.
LastNodeSelected
explain Exclusivo dos campos do tipo TreeView
Procedimentos
Um Procedimento serve para salvar sequências de instruções em um bloco. Cada procedimento criado fica na lista de procedimentos e pode ser vinculado a outros procedimentos recursivamente.
Criando um Procedimento
Procedimentos são criados automaticamente quando se adiciona uma lista de instruções para um Evento. Eles também podem ser criados manualmente ao clicar em botão direito -> adicionar na lista de procedimentos.
Usando um Procedimento
Procedimentos podem ser reutilizados em uma lista de instruções e vinculados a eventos que não são o seu evento de origem.
Funções
Igual a procedimento porém com resultado (retorno).
Criando uma Função
Funções somente podem ser criadas na lista de funções pelo comando botão direito -> adicionar. Quando isso for feito, uma tela de edição será aberta. Nela, nome, descrição e tipo de retorno podem ser especificados. A lista de instruções deve ter pelo menos um retorno e este deve ser especificado.
Utilizando uma Função
Uma função pode ser chamada em um procedimento ou em uma função, recursivamente. Quando isso for feito, uma variável deve ser escolhida para receber o valor de retorno da função escolhida.
Editando uma lista de Instruções
Para incluir a primeira instrução em uma lista, clique com o botão direito do mouse em Procedimento ou Função e, em seguida, em adicionar e escolha uma instrução. Também é possível colar uma lista diretamente. Para incluir ou modificar instruções, basta clicar com o botão direito no lugar desejado e selecionar a ação desejada.
- Inserir abaixo
- Copiar / Colar / Recortar:
Permitem a reutilização de código e podem ser usadas em diferentes listas de instruções.
- Habilitar e Desabilitar
Também é possível arrastar as instruções; É em cascata então se uma coisa for deletada tudo que depende dela vai ser deletado junto;
Declaração de Controle
Instruções de desvio de código. IF, WHILE, RETURN, CONTINUE, CONTINUE WHEN, BREAK, BREAK WHEN ;
Ação
Controle de Campos
Comandos para alterar valores e propriedades de campos dinamicamente.
Mostrar Campos / Ocultar Campos
Altera a visibilidade da lista de campos selecionados.
Habilitar Campos / Desabilitar Campos
Altera a capacidade de edição pelo usuário da lista de campos selecionados.
Atribuir Somente Leitura / Remover Somente Leitura
Altera a propriedade 'Somente Leitura' da lista de campos selecionados.
Atribuir Foco
Altera a seleção usada na navegação com Tabs no Latromi WEB para o campo selecionado.
Tornar Campo Obrigatório / Tornar Campo Opcional
Altera a propriedade de obrigatoriedade da lista de campos selecionados.
Comandos internos
Popular Campos e Variáveis
Selecione campos e variáveis e defina os valores que serão atribuídos a eles dentre as várias opções.
Mostrar Mensagem
Escreva uma mensagem que aparecerá em modo popup e defina seu tipo. A mensagem pode conter substituições.
Abrir URL
Escolha o alvo e o endereço URL a ser aberto. O endereço URL pode conter substituições.
Abrir Lookup
Abre um Lookup existente no formulário.
Abrir Janela
Abre uma Janela existente no formulário. Escolha se será aberta maximizada e se será modal.
Chamar Procedimento
Chama um Procedimento existente no formulário e permite a passagem de parâmetros.
Chamar Função
Chama uma função existente no formulário e solicita uma váriável de retorno. Permite a passagem de parâmetros.
Códigos em outras linguagens
Comandos C#, Java, DB
Comandos de Banco de Dados
Rollback e Commit
Controle da Janela
- rascunho - descrição detalhada do funcionamento.
Fechar
Chama o Closing().
- Se já estiver no Closing, fecha direto.
- Se o Cancelar Evento estiver no meio do procedimento, o que vier depois dele será executado.
- Se tiver um Cancelar Evento e depois um Close(), todos os comandos até o primeiro Close() serão executados e o formulário não será fechado.
Reiniciar
Reinicia o Formulário.
- Não trigga Closing. Trigga o Load. Depois desse comando, as outras ações do BDI são executadas = reinicia e depois continua o procedimento/função.
Cancelar Evento
Cancela o fechamento do formulário.
- Só funciona no closing? parece que sim.
Confirmar Uploads
Tenta realizar os uploads dos campos de Upload.
Notificar Ação Concluída
Notifica o usuário do Latromi WEB que a operação foi concluída com sucesso no rodapé da janela do Formulário.
Comentários
Comentários de texto podem ser adicionados a uma lista de instruções para melhorar a legibilidade do código.