Lista Dinâmica

Manual do Maker 2

  Lista Dinâmica

A Lista Dinâmica é um componente que permite que o usuário possa visualizar uma lista de dados proveniente de uma determinada tabela, que não é a tabela principal do formulário atual. Quando a informação é selecionada desta lista, o dado é gravado em um campo correspondente da tabela principal.

Podemos configurar a Lista Dinâmica para consultas e informações de tabelas existentes no sistema. Para isso, utilizamos as propriedades Campo, Descrição, SQL, Campo-Chave, Campo Lista e as demais propriedades, se assim por necessário.

Observação:

  • É comum utilizar a propriedade Formulário para indicar a origem da lista e a propriedades Subformulário, definindo SIM, para permitir a chamada da origem pelo clique no botão (Exibir formulário de origem);

  • O componente possibilita a utilização de chave composta. Chave composta é quando o identificador único de uma tabela é formado por dois ou mais campos, que podem ou não ser chaves primárias. Para proceder a essa configuração, siga os passos abaixo:

    1. Na consulta que está vinculada ao componente, escreva os nomes dos campos que compõem a chave separados por ponto e vírgula na propriedade Campo chave;

    2. Na consulta que está vinculada ao formulário, escreva os nomes dos campos que compõem a chave separados por ponto e vírgula na propriedade Campo. Exemplo: campo1;campo2;campo3.

A propriedade Campo, definirá onde a informação selecionada será guardada. Colocamos o nome de um campo que esteja presente na consulta do SQL criada na tela principal.

A propriedade Descrição definirá o rótulo do campo no formulário.

A propriedade SQL determinará a consulta que proporcionará os dados para o campo. Nessa propriedade, abre-se uma janela para construirmos o código em SQL que será necessário para alimentar a lista apresentada na Lista Dinâmica. Esse SQL é particular desse componente, ou seja, só ocorrerá quando ele for solicitado.

A propriedade Campo Lista exibirá o conteúdo para o campo do formulário, e a propriedade Campo Chave refere-se ao campo que será o relacionamento lógico entre a tabela principal do formulário e a consulta para o campo.

O componente Lista Dinâmica possui algumas funcionalidades que são nativas em modo de execução.

  • Quando está editando um campo, em modo de inserção ou alteração, o componente possui controles para facilitar a busca de informações:

    • Os controles (iniciando por), (terminando por), (igual a) e (contendo), alternam-se ao receber um clique ou, quando combinamos com as teclas CTRL + <barra de espaço>, auxiliam para busca de contexto;

    • A Barra de Digitação corresponde ao espaço para entrada do contexto da busca;

    • O botão (Localizar) executa a busca.

  • Quando se está editando um campo, em modo de inserção ou alteração, ao pressionar a tecla F5, o formulário declarado na Propriedade Formulário, é aberto. Observe que isso depende também da Propriedade Subformulário definida SIM.

  • Além das funcionalidades citadas, também é possível criar um formulário a partir da "Lista Dinâmica". Para isso, devem ser seguidos os seguintes passos:

    1. Insira o componente Lista Dinâmica no formulário;

    2. Com o duplo clique sobre a componente, abrirá a tela Assistente de Criação de Novo Formulário (nesta tela devem ser feitas as configurações necessárias para a criação do formulário);

    3. Salve o novo formulário criado, fechando-o em seguida.

Observação: Concluídos esses passos, as propriedades "Descrição", "SQL", "Campo Chave", "Campo Lista" e "Formulário" serão preenchidas automaticamente.

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

Observações:

  • Ao vincular dados ao componente Lista Dinâmica, os campos "Campo Chave" ou "Campo Lista" deverão ser marcados, pois caso a aba de navegação do formulário esteja hablitada um erro será apresentado.

  • Definindo a lista dinâmica como Apenas Leitura pelo Modo Gerente (Webrun), o acesso ao formulário do componente sempre estará habilitado (para Inclusão, Alteração ou Exclusão).

  • Uma vez utilizada uma concatenação (propriedade SQL) para o Campo Lista (propriedade) do componente Lista Dinâmica, não é possível utilizar o filtro de pesquisa disponibilizado pelo próprio componente (em um formulário no Webrun).

  • Tecla [Enter] - Aplica o filtro informado na lista dinâmica.

____________________________________________________________________________

Caso este tópico não tenha comentário satisfatório, envie e-mail para [email protected]