Apresentação

O widget SearchPicker, permite criar facilmente as áreas estandarte de pesquisa, similares as encontradas nos navegadores ou barras de ferramentas. A aparência da área depende da plataforma.

Windows: Mac OS:

O texto que se mostra por padrão na área pode ser controlado por programação, utilizando o método componente SearchPicker SET HELP TEXT.

Além de sua aparência, uma área de pesquisa SearchPicker se caracteriza pelos seguintes elementos: texto em cinza, uma área de entrada e um ícone de eliminação.

• A área de entrada é onde o usuário introduz o valor a buscar. Este valor é atribuído automática e dinamicamente a variável associada a área na lista de propriedades (propriedade "Nome de variável"). Utilize esta variável para proporcionar o valor buscado ao método de pesquisa.
• O texto cinza é uma ajuda que indica ao usuário ele ou o(s) campo(s) onde se realizaram a pesquisa. Desaparece tão rápido como a área teme o foco. Este texto pode ser definido via o comando SearchPicker SET HELP TEXT.
• O botão de eliminação permite apagar o conteúdo da área. Seu funcionamento é automático.

Durante a execução, pode iniciar seu método de pesquisa fazendo clique no botão ou em um evento formulário. A área gera de forma concreta os eventos On Data Change e On Losing Focus. Pode oferecer uma pesquisa dinâmica que seja reavaliada cada vez que o usuário introduz outro caractere mediante uma chamada ao método de pesquisa no evento On Data Change. Também pode iniciar a pesquisa quando o usuário pressiona a tecla Intro: neste caso, só tem que chamar ao método de pesquisa no evento On Losing Focus.

Pode inserir uma área SearchPicker de duas formas:

• Inserindo um objeto "SearchPicker" da livraria de objetos pré configurados de 4D (tema "áreas de entrada").
• Criando uma área de subformulário e atribuindo ao formulário detalhado SearchPicker.
  

A continuação, especifique o nome da variável associada ao subformulário (propriedade "Nome da variável" na Lista de propriedades). Quando o formulário se executa, esta variável conterá automaticamente o valor buscado pelo usuário. A continuação, pode passar este valor a seu método de pesquisa personalizado.