4D Doc Center : QUERY BY EXAMPLE

4D v14.3

QUERY BY EXAMPLE


QUERY BY EXAMPLE ( {tabela}{;}{*} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela para a qual vai retornar a seleção de registros, ou a tabela Padrão, se omitido
*	Operador	Se passado, a barra de rolagem não será exibida

Descrição

QUERY BY EXAMPLE realiza a mesma ação que o comando de menu Pesquisa por formulário... no ambiente Desenho. Este comando mostra o formulário de entrada atual como janela de pesquisa. QUERY BY EXAMPLE busca em tabela os dados que o usuário introduz na janela de pesquisa. O formulário deve conter os campos que você queira utilizar para realizar a pesquisa. A pesquisa é otimizada; os campos indexados são utilizados automaticamente para otimizar a pesquisa.

Ver o manual de Desenho de 4D para maior informação sobre a utilização do comando de menu pesquisa por formulário... do ambiente Desenho.

Exemplo

O método neste exemplo mostra o formulário minhaPesquisa. Se o usuário aceita o formulário e executa a Pesquisa (ou seja, se a variável sistema OK toma o valor 1), são mostrados os registros que cumprem com o critério de Pesquisa:

 FORM SET INPUT([Pessoas];"minhaPesquisa") ` Passar ao formulario de entrada

 QUERY BY EXAMPLE([Pessoas]) ` Mostrar o formulário e realizar a pesquisa

 If(OK=1) ` Se o usuário valida a pesquisa

    DISPLAY SELECTION([Pessoas]) ` Mostrar os registros

 End if

Variáveis e conjuntos do sistema

Se o usuário clicar no botão Aceitar, ou pressionar a tecla Enter, a variável sistema OK toma o valor 1, e a pesquisa é realizada. Se o usuário clicar no botão Cancelar, ou pressiona a tecla de anulação, a variável sistema OK toma o valor 0, e a pesquisa é cancelada.