Lista Dupla

O componente Lista Dupla é utilizado para suporte à relação de muitos para muitos entre tabelas. Devem ser envolvidas no processo de configuração do componente três tabelas: duas contendo identificadores únicos (chaves primárias) e uma terceira armazenando a relação das duas anteriores por meio de seus identificadores (chaves estrangeiras).

Neste componente é possível selecionar um ou mais registros ao mesmo tempo para serem inseridos na tabela que relaciona as tabelas que contêm os identificadores únicos.

O componente só é manipulável se o formulário estiver em modo de inserção ou alteração:

Todos os componentes possuem Propriedades e Eventos. Para conhecê-los clique aqui.

O componente Lista Dupla não suporta a utilização de chave composta
Não é possível selecionar uma conexão adicional a este componente.
Este componente não registra Log, ou seja, não aparecerá nos Logs do webrun as ações de inserções, alterações ou deletações deste componente (Lista Dupla).
O número de vezes que o evento será executado está relacionado em quantos registros foram selecionados para inserção ou remoção ao mesmo tempo;
Todo fluxo de ação, uma vez vinculado a qualquer um dos eventos do componente Lista Dupla, recebe dois parâmetros automáticos. Para que esses parâmetros sejam obtidos corretamente pelo fluxo de ação, quando executados no Webrun, é necessária a criação de dois Parâmetros de Entrada: o primeiro parâmetro pode ser chamado de Campo Chave (nome opcional - correspondendo ao código do registro (ou registros) que participará do evento); e o segundo parâmetro pode ser chamado de Campo Lista (nome opcional - correspondendo à descrição do registro (ou registros) que participará do evento).
Caso um registro (nome do registro) contido na área direita ou esquerda do componente exceda a largura de uma das áreas, basta posicionar o ponteiro do mouse sobre o registro para que apareça um hint (dica) demonstrado o nome completo do registro.
Este recurso está disponível apenas para a versão Enterprise.
O hint (Dica) só será exibido ao passar o mouse sobre a moldura que envolve o componente.

Ao selecionar a opção Não, o botão

ficará invisível. O botão

é utilizado para a retirada de um registro que está contido na área esquerda do componente (disponível) e, em seguida, inclusão do mesmo registro na área direita do componente (selecionado). Por padrão, esta propriedade vem configurada como Sim.

Ao selecionar a opção Não, o botão

ficará invisível. O botão

é utilizado para a retirada de vários registros que estão contidos na área esquerda do componente (disponíveis) e, em seguida, inclusão dos mesmos registros na área direita do componente (selecionados). Por padrão, esta propriedade vem configurada como Sim.

Esta propriedade representa o campo-chave (identificador único) selecionado durante a configuração da propriedade SQL Principal, o qual identifica a tabela que se quer relacionar com a tabela associada ao formulário no qual está contido o componente.

Esta propriedade representa o campo ao qual será atribuído o código do registro que é selecionado na área esquerda do componente.

Exibe a descrição do campo-chave selecionado na propriedade Campo-Chave Principal.

Exibe a descrição do campo-chave selecionado na propriedade Campo-Chave Selecionados. Normalmente é feita uma junção entre a tabela que contém os registros que aparecem na área esquerda do componente (registros disponíveis) e a tabela que relaciona as tabelas do formulário e dos registros disponíveis para projetar o campo da descrição do registro selecionado.

Descrição que identifica a área dos registros que estão disponíveis para seleção.

Descrição que identifica a área dos registros que foram selecionados e estão relacionados com o registro corrente no formulário.

Sim - após a efetuação de clique duplo sobre um registro que esteja na área esquerda do componente (registro disponível), este passará para a área direita do componente (registro selecionado);
Não - um registro que esteja na área esquerda do componente (registro disponível) só poderá passar para a área direita do componente (registro selecionado) através dos botões de seleção posicionados entre a área esquerda e direita do componente.

Utilizada para edição da fonte contida na expressão definida para a propriedade Descrição Principal. Esta propriedade é idêntica à propriedade Fonte.

Utilizada para edição da fonte contida na expressão definida para a propriedade Descrição Selecionados. É semelhante à propriedade Fonte.

Esta propriedade identifica a relação entre os registros da área Principal do componente Lista Dupla com o formulário principal ou com outros componentes.

Caso se queira filtrar os dados da área esquerda do componente, deve ser relacionado um (ou mais) campo da tabela associada ao formulário a um (ou mais) campo correspondente na tabela que contém os registros que poderão ser selecionados. Esta propriedade é idêntica à propriedade Parâmetros.

Esta propriedade tem o mesmo objetivo da propriedade Parâmetros Principal, sendo que o filtro será realizado para a área Selecionados do componente. Deve ser relacionado o campo-chave da tabela associada ao formulário ao campo correspondente (chave estrangeira) na tabela que contém os campos que relacionam as tabelas. Esta propriedade é idêntica à propriedade Parâmetros.

Ao selecionar a opção Não, o botão

ficará invisível. O botão

é utilizado para a retirada de um registro que estava contido na área direita do componente (selecionado) e, em seguida, inclusão do mesmo registro na área direita do componente (disponível). Por padrão, esta propriedade vem configurada como Sim.

Ao selecionar a opção Não, o botão

ficará invisível. O botão

é utilizado para a retirada de vários registros que estavam contidos na área direita do componente (selecionados) e, em seguida, inclusão dos mesmos registros na área esquerda do componente (disponíveis). Por padrão, esta propriedade vem configurada como Sim.

Consulta que contém a tabela que se quer relacionar com a tabela associada ao formulário no qual está contido o componente. Esta propriedade tem o mesmo comportamento da propriedade SQL.

Consulta que contém a tabela que possui os campos que relacionam registros da tabela associada ao formulário e a tabela selecionada na consulta da propriedade SQL Principal (registros disponíveis). Esta propriedade tem o mesmo comportamento da propriedade SQL.

O evento ocorre entre o momento em que o usuário clica sobre o botão

para adicionar todos os registros na área Selecionados.

O evento ocorre entre o momento que o usuário clica sobre o botão

para adicionar o registro selecionado na área Principal para a área Selecionados.

O evento ocorre entre o momento em que o usuário clica sobre o botão

para retirada de um registro selecionado na área Selecionados para a área Principal.

O evento ocorre entre o momento em que o usuário clica sobre o botão

para mover todos os registros contidos na área Selecionados para área Principal.

O evento ocorre após o momento que o usuário clica sobre o botão

(Adicionar item).

O evento ocorre após o momento em que o usuário clica sobre o botão

(Adicionar todos).

O evento ocorre após o momento em que o usuário clica sobre o botão

(Remover item).

O evento ocorre após o momento que o usuário clica sobre o botão

(Remover todos).

O evento ocorre no momento em que o usuário efetua um Duplo-Clique sobre qualquer registro contido na área esquerda ou direita do componente.

Propriedades

Ajuda

Ver descrição da propriedade Dica.

Altura

Esta propriedade determina a altura do componente/formulário.

Apenas Leitura

Ao selecionar a opção Sim, o componente aparece somente em modo de leitura, não podendo ser editado. Por padrão esta propriedade vem configurada como Não.

Esta propriedade não se aplica aos componentes Subformulário, Botão, Árvore e Moldura.

Campo

Esta propriedade representa a coluna da tabela selecionada como fonte de dados do formulário. São disponibilizados para seleção todos os campos da fonte de dados vinculada. Quanto ao componente:

Imagem - O campo no banco de dados deve ser de um tipo que dê suporte à imagem ou de um tipo texto (campo que suporte alta precisão). Utilizando a primeira opção, o byte da imagem será gravado no campo da tabela vinculada ao formulário; já na segunda opção, o Webrun copiará a imagem para a pasta C:\Arquivos de programas\Softwell Solutions\Maker 3\Webrun 3tomcat\webapps\<contexto do Webrun>\files, guardando o caminho do arquivo no campo.

Esta propriedade não se aplica aos componentes Lista Dupla, Botão, Árvore, Subformulário, Gráfico e Moldura.

Código

Aplicado a todos os componentes e formulário. Esta propriedade representa o identificador do objeto, seja ele componente ou formulário. É utilizado para armazenar as propriedades de cada objeto no banco de dados. Esta propriedade é gerenciada automaticamente pelo Maker.

Esta propriedade altera a cor de fundo do componente/formulário. São disponibilizadas várias cores para que o usuário possa alterar a cor de fundo-padrão (branco) do objeto desejado.

Observações:

Os componentes Caixa de Texto, Grade, Lista dinâmica, Lista, Texto Longo, Árvore e Texto aplicam a cor de fundo selecionada independente da propriedade Habilitado (de cada componente) estiver marcada como Sim ou Não. Já os componentes Lista dupla, Check, Opções e Botão só aplicam a cor de fonte selecionada quando a propriedade Habilitado estiver marcada como Sim.
Especificamente para o componente Texto, fica definido que o valor -1 na propriedade definirá Transparente para cor de fundo. Dessa forma, o componente não ficará com fundo cinza.

Esta propriedade não se aplica aos componentes Subformulário, Árvore, Imagem e Botão.

Descrição

Esta propriedade aplica uma legenda que aparece sobre o componente para identificar (resumidamente) qual a sua função.

Esta propriedade não se aplica aos componentes Árvore, Grade, Moldura, Imagem e para o objeto formulário.

Ao selecionar um campo, o Maker sugere uma descrição obtida no dicionário de dados e, caso o usuário deseje deixar o campo da descrição em branco basta apagá-lo e clicar fora do componente.

Dica

Esta propriedade permite que seja configurada uma mensagem com explicação sobre a finalidade do componente/formulário. Clicando sobre o botão nessa opção (Dica/Ajuda), aparece uma janela para que o usuário possa descrever qual a função do componente/formulário. No Webrun, para visualizar a descrição, o usuário deve selecionar o componente com um clique sobre ele e pressionar a tecla F1.

Esta propriedade não se aplica ao componente Subformulário.

Fonte

Aplicada aos componentes Botão, Caixa de Texto, Check, Grade, Lista, Opções, Texto e Texto Longo - clicando sobre o botão nesta opção, aparece a janela Fonte para que o usuário possa editar as configurações relativas à fonte que aparece no componente. São elas:

- a Fonte - lista todos os tipos de fonte passíveis de escolha;
- o Estilo da fonte - lista todos os tipos de layout que podem ser selecionados;
- o Tamanho - espaço para especificação do tamanho da fonte;
- o agrupamento Efeitos - a opção Riscado insere uma linha horizontal no meio da fonte; a opção Sublinhado insere uma linha horizontal sob a fonte; e a caixa de seleção Cor, na qual é possível modificar a cor da fonte;
Os componentes Botão, Check, Lista Dinâmica, Lista, Lista Dupla e Opções aplicam a cor de fonte selecionada quando a propriedade Habilitado (de cada componente) estiver marcada como Sim.
- o Exemplo - local que permite a pré-visualização das configurações adotadas;
- o Script - convenções de grupos de fontes adotadas por continentes e/ou países para expressar sua língua na forma escrita.

Observações:

Os componentes Caixa de Texto, Grade, Texto Longo, Árvore e Texto aplicam a cor de fonte selecionada independente da propriedade Habilitado (de cada componente) estiver marcada como Sim ou Não.
Para confirmar as alterações, o usuário deve clicar no botão OK, caso contrário, deve clicar no botão Cancelar.

Formulário:

Esta propriedade permite a seleção de um formulário que poderá ser aberto dentro de uma situação pré-determinada. É aplicada aos componentes Botão, Grade, Lista Dinâmica e Subformulário - Quando selecionada a opção:

Botão - selecionando o nome de um formulário nesta opção, em seguida, deve-se utilizar a propriedade Parâmetro. O formulário abre de acordo com a configuração feita no item citado;
Grade - selecionando o nome de um formulário, em seguida, deve-se utilizar a propriedade Parâmetro. O formulário selecionado será apresentado em formato de colunas (componente vinculado a um campo da fonte de dados do formulário) na grade. Alguns componentes podem não aparecer na grade devido à configuração feita na propriedade Editável;
Lista Dinâmica - selecionando o nome de um formulário nessa opção, aparece o botão (Acessar Formulário) ao lado do campo (no Webrun). Para acessar o formulário o usuário deve clicar sobre o botão;
Subformulário - selecionando o nome de um formulário nesta opção e, em seguida, deve-se utilizar a propriedade Parâmetro. Este formulário deverá conter apenas uma aba, caso o mesmo possua mais de uma será(ão) exibido(s) o(s) componente(s) de todas as abas sobrepostos.

Habilitado

Ao selecionar a opção Sim, o componente aparece habilitado para poder ser editado ou manipulado.

Observação: Os componentes Caixa de Texto, Grade, Lista dinâmica, Lista, Texto Longo, Árvore e Texto aplicam a cor de fundo selecionada independente da propriedade Habilitado (de cada componente) estiver marcada como Sim ou Não. Já os componentes Lista dupla, Check, Opções e Botão só aplicam a cor de fonte selecionada quando a propriedade Habilitado estiver marcada como Sim.

Esta propriedade não se aplica aos componentes Gráfico e Moldura.

Imagem

Aplicada aos componentes Botão e Imagem ao objeto formulário

Lista

Aplicada aos componentes Lista e Opções

Nome

Esta propriedade é utilizada para identificar/nomear o componente/formulário. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar que mais de um componente possua o mesmo nome.

Paginação

Aplicada aos componentes Grade e Lista Dinâmica

Parâmetros

Aplicada aos componentes Árvore, Botão, Grade, Lista Dupla e Subformulário - para que seja possível configurar essa propriedade, é necessário, antes, executar a configuração explicada na propriedade Formulário, e em seguida, acesse o tópico Campos de Ligação.

Posição X

Aplicada a todos os componentes, exceto ao objeto formulário - determina a posição do componente em relação à esquerda do formulário.

Posição Y

Aplicada a todos os componentes, exceto ao objeto formulário - determina a posição do componente em relação ao topo do formulário.

Quebra Automática...

Aplicada aos componentes Texto e Texto Longo

Subformulário

Aplicada aos componentes Grade e Lista Dinâmica

Tabulação

Esta propriedade indica a ordem de tabulação do componente em relação aos outros que compõem a aba do formulário na qual está posto. Essa ordem pode ser observada quando o usuário altera o estado do formulário/grade para o modo de inclusão ou edição e navega entre os componentes/campos usando a tecla Tab.

Esta propriedade não se aplica aos componentes Texto e Moldura e ao objeto formulário.

Tabular

Ao selecionar a opção Sim, quando o usuário estiver navegando entre os componentes, como foi descrito no item anterior, o componente receberá foco (observada a ordem de tabulação).

Esta propriedade não se aplica aos componentes Texto e Moldura e ao objeto formulário.

Observação: A propriedade Tabular dos componentes Botão e Opções tem como valor padrão a opção Não, quanto aos demais componentes aos quais a propriedade se aplica, o valor padrão é Sim.

Tamanho

Determina a largura do componente ou formulário.

Tipo

Aplicado aos componentes Caixa de Texto, Check, Grade, Lista, Opções e Texto Longo - permite escolher um tipo de dado para se aplicar uma máscara. Caso o campo não esteja ligado ao banco, ela deverá ser usada junto com a propriedade Conteúdo.

Esta propriedade não se aplica aos componentes Texto, Grade, Subformulário, Imagem, Árvore, Gráfico e Moldura.

Observação: A propriedade Tipo aplicada ao componente Lista Dinâmica está depreciada.

Visível

Permite ocultar/exibir um componente. Selecionando a opção Não, o componente não aparecerá no formulário.

Esta propriedade não se aplica ao componente Moldura e ao formulário.

Eventos

Todos os componentes/formulários possuem Eventos vinculados a eles. Para configurar um evento de um componente/formulário, clique com o botão direito do mouse e no menu suspenso que se abre e escolha qualquer um dos eventos disponíveis em Eventos.

Ao Clicar

Aplicado a todos os componentes, com exceção do Sub-Formulário, da Lista Dupla e do objeto formulário - o evento é executado assim que o usuário efetua um clique com o botão esquerdo do mouse sobre o componente ou quando o componente for um botão, pressionando a tecla Enter.

Para o componente Árvore - o evento ocorre entre o momento em que o usuário clica sobre a pasta ou sobre um item de uma pasta (nó).

Observações:

Ao utilizar este evento no componente Grade, ou em um componente Botão dentro de uma Grade, com a função Grade - Obter Linha Selecionada, sempre irá obter a linha anteriormente marcada. Este comportamento ocorre devido a ação de focar a linha ser executada depois da ação do fluxograma executado, ou seja, primeiro o fluxo que obtém o valor da linha é executado e depois a linha é focada.
Os símbolos "+" (mais) e "-" (menos) são utilizados para mostrar e ocultar os itens ou pastas de uma pasta, respectivamente nesta ordem.
O evento Ao Clicar é anulado nos componentes Check, Opções, Imagem, Texto Longo (HTML Básico) e Texto Longo (HTML Avançado) quando os mesmos estão com a propriedade Apenas Leitura marcada como SIM.

Ao Entrar

Aplicado aos componentes Caixa de Texto, Grade, Lista, Lista Dinâmica e Texto Longo e ao objeto formulário - no caso de um:

Componente - o evento é executado assim que o usuário efetua um clique com o botão esquerdo do mouse sobre o componente ou quando o componente recebe o foco;
Formulário - o evento é executado assim que o usuário abrir o formulário.

Observação: Caso este evento contenha uma ação com intuito de alterar, substituir ou desfazer o conteúdo, contido no componente Texto Longo, este com a propriedade HTML Básico ou HTML Avançado, é necessário fazer esta alteração a partir de um fluxo chamado pela função Agendar Execução de Fluxo.

Ao Modificar

Aplicado aos componentes Grade, Caixa de Texto, Check, Lista Dinâmica, Imagem, Lista, Opções e Texto Longo - o evento é executado assim que o usuário efetua qualquer modificação no valor contido no componente e também quando navega entre os registros, desde que o valor contido no componente em um registro difira do valor contido no componente para o qual o usuário navegar: o próximo registro ou o registro anterior.

Ao Pressionar Tecla

Aplicado aos componentes Caixa de Texto, Texto Longo, Lista Dinâmica, e ao objeto formulário. O fluxo de ação associado a este evento deve possuir cinco parâmetros de entrada (três do tipo Lógico, um do tipo Inteiro e um do tipo Letras, respectivamente nesta ordem), os quais são preenchidos automaticamente pelo Webrun no momento da execução do fluxo. Por padrão (opcional), sugere-se para os nomes dos parâmetros de entrada Alt, Crtl,e Shift para cada tipo Lógico, Código da Tecla para o tipo Inteiro e Caracter da Tecla para o tipo Letras.

Observações:

O evento é disparado quando QUALQUER tecla for pressionada. Isso não vale para as teclas Alt, Ctrl e Shift, pois elas são capturadas quando executadas em conjunto com outra tecla. Exemplo: Ctrl + S.
O evento não detecta o disparo das teclas Tab, Enter, Backspace e Setas de Navegação uma vez que essas teclas possuem o efeito de tabulação e acesso para o próximo componente. Logo, caso queira que ocorra algo quando essas teclas sejam pressionadas, deve ser utilizado no evento Ao Sair.
Caso o evento Ao Pressionar Tecla associado a um componente retorne CANCELEVENT, o evento não será propagado, ou seja, poderá ser criada uma verificação em um fluxo que a depender do resultado, permite impedir que um determinado conteúdo não vá diretamente para o componente. Exemplo:
1. Caso o usuário tecle a letra "a", podemos verificar, no fluxo, caso o caractere tenha sido "a" retornamos "CANCELEVENT" (Letras) e desta forma o caractere "a" não será escrito no componente.

Ao Sair

Aplicado aos componentes Caixa de Texto, Lista, Lista Dinâmica, Texto Longo e ao objeto formulário. No caso de um:

Componente - o evento é executado assim que o componente perde o foco;
Formulário - o evento é executado assim que o usuário clica com o botão esquerdo do mouse sobre o botão Sair do formulário.