Mudanças entre as edições de "Formulário Dinâmico:Programação"
(→Eventos: todos os eventos e onde ocorrem) |
m (→Declaração de Controle: Retirando texto rascunho) |
||
(14 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
Linha 10: | Linha 10: | ||
===Closing=== | ===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). | 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 | + | 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=== | ===Eventos de Campos=== | ||
Linha 21: | Linha 21: | ||
Exclusivo dos campos do tipo botão. | Exclusivo dos campos do tipo botão. | ||
====CheckedChanged==== | ====CheckedChanged==== | ||
− | + | Dispara quando o valor for alterado. | |
Existe nos campos de tipo: CheckBox, Consulta. | Existe nos campos de tipo: CheckBox, Consulta. | ||
+ | |||
====SelectedItemChanged==== | ====SelectedItemChanged==== | ||
− | + | Dispara quando o valor selecionado for alterado. Existe nos campos de tipo: Combobox, LookUp, RadioButton. | |
− | Existe nos campos de tipo: Combobox, LookUp, RadioButton. | + | |
====PopUpItemSelected==== | ====PopUpItemSelected==== | ||
''explain'' | ''explain'' | ||
Linha 60: | Linha 61: | ||
====LastNodeSelected==== | ====LastNodeSelected==== | ||
+ | ''explain'' | ||
Exclusivo dos campos do tipo TreeView | Exclusivo dos campos do tipo TreeView | ||
Linha 65: | Linha 67: | ||
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. | 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 === | === 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. | + | 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 === | === 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 == | == Funções == | ||
Igual a procedimento porém com resultado (retorno). | Igual a procedimento porém com resultado (retorno). | ||
=== Criando uma Função === | === 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 === | === 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 == | == Editando uma lista de Instruções == | ||
Linha 91: | Linha 93: | ||
== Declaração de Controle == | == Declaração de Controle == | ||
− | + | Instruções de desvio de código. | |
− | IF, WHILE, RETURN, CONTINUE, CONTINUE WHEN, BREAK, BREAK WHEN | + | IF, WHILE, RETURN, CONTINUE, CONTINUE WHEN, BREAK, BREAK WHEN ; |
+ | |||
== Ação == | == Ação == | ||
=== Controle de Campos === | === Controle de Campos === | ||
Comandos para alterar valores e propriedades de campos dinamicamente. | 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 === | === Comandos internos === | ||
− | Chamar | + | |
+ | ==== 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 === | === Códigos em outras linguagens === | ||
Comandos C#, Java, DB | Comandos C#, Java, DB | ||
Linha 104: | Linha 143: | ||
Rollback e Commit | Rollback e Commit | ||
=== Controle da Janela === | === Controle da Janela === | ||
− | Fechar, Reiniciar, Cancelar | + | * 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 == | ||
− | + | Comentários de texto podem ser adicionados a uma lista de instruções para melhorar a legibilidade do código. | |
− | |||
− | |||
== Ver Também == | == Ver Também == | ||
* [[Formulário_Dinâmico:Visão_Geral|Visão Geral do Formulário Dinâmico]] | * [[Formulário_Dinâmico:Visão_Geral|Visão Geral do Formulário Dinâmico]] |
Edição atual tal como às 11h33min de 8 de julho de 2021
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.