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:
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;
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:
Insira o componente Lista Dinâmica no formulário;
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);
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]