Mudanças entre as edições de "Formulário Dinâmico:Programação"

De LATROMI Manuais
Formulário Dinâmico:Programação
Ir para: navegação, pesquisa
(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??, não deixando a tela ser fechada pelo usuário.??
+
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====
''explain''
+
Dispara quando o valor for alterado.
 
Existe nos campos de tipo: CheckBox, Consulta.
 
Existe nos campos de tipo: CheckBox, Consulta.
 +
 
====SelectedItemChanged====
 
====SelectedItemChanged====
''explain''
+
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 ===
//Como vincular. Acho que é só isso mas tomara que tenha mais para falar aqui
+
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 ===
Rascunho:
+
Funções somente podem ser criadas na lista de funções pelo comando ''botão direito -> adicionar''.  
Não tem criação automática. Só pode ser criada adicionando direto na lista de funções.  
+
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.
Vai abrir a tela de edição de função e um retorno deve ser escolhido.
 
  
 
=== 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 ==
Clássicos da programação iterativa/monolítica: '''instruções de desvio de código'''.
+
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 procedure, abrir janela, popular campos, ...
+
 
 +
==== 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 evento, ...
+
* 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 ==
São comentários. Podem
+
Comentários de texto podem ser adicionados a uma lista de instruções para melhorar a legibilidade do código.
 
 
Evento de um botão. Dispara quando o botão for apertado...
 
  
 
== 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.


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.

Ver Também