Skip to end of metadata
Go to start of metadata

Função

Esse componente exibe opções fixas de seleção para o usuário (Figura 1). Muito utilizado em situações onde existe a necessidade de utilizar uma lista de opções com valores fixos ou enviar valores recorrentes - Seja para manter o padrão de inserção no banco de dados ou para dar comodidade ao usuário. 

Figura 1 - Caixa de seleção

Configuração

A configuração do componente é a mais importante das propriedades, pois é através dela que todos os ajustes como o placeholder, os valores que irão aparecer na caixa de seleção fixa e como será definido a filtragem.

Ao selecionar o componente na área de trabalho da IDE, será apresentado a aba de propriedades no campo direito. O menu de "..." que aparece ao lado do campo de configuração permite que você faça as configurações e nela contém as abas geral, template cabeçalho e template rodapé.

Geral

Figura 2 - Conteúdo da aba geral

Apresenta as configurações mais usuais, como de adicionar ou remover uma opção da lista, renomear uma opção e entre outros.

  1. Placeholder: mostra um texto na caixa de seleção que serve para auxiliar o usuário ao que ele precisa fazer, mas seu uso é opcional.
  2. Tipo Filtro: define a forma de pesquisa da lista de opções:
    • Contendo: procura por quaisquer letras consecutivas escritas que se encaixem nas opções da lista.
    • Iniciando com: faz a busca pelas letras iniciais consecutivas de cada opção dessa lista.
    • Final com: faz a busca pelas letras finais consecutivas.
  3. Valor chave: define o conteúdo que será apresentado ao sistema.
  4. Valor exibição: define o conteúdo que será mostrado na caixa de seleção.

Caso deseje remover alguma opção, clicar no ícone de lixeira.O ícone de escrita faz a edição da mesma.

Valor chave e valor exibição

Valor chave define o conteúdo que será utilizado pelo sistema, enquanto o valor exibição irá mostrar as opções na caixa de seleção. Eles podem ser iguais ou não, dependendo do tipo da chave.

Por exemplo, tem-se a opção com o valor de exibição chamado oi e seu valor chave é hello. Enquanto na tela será exibido oi, o sistema estará usando hello no lugar.

Adicionar novo valor chave

Para adicioná-lo, basta clicar no botão + que abrirá uma janela para definir. As opções para como vai ser o tipo do valor chave é apresentado ao lado da caixa e são eles: texto, numérico, data e hora, hora, lógico e expressão. Mas, através do clique no ícone destacado, é possível trazer novas formas de dados para adicionar valores.

O campo valor exibição permanece sempre, mas ele sempre será relacionado ao valor chave, não importando qual é o seu tipo. Por exemplo, caso o valor chave seja do tipo lógico com valor true e o valor exibição seja sim, será exibido na caixa de seleção sim mas ao seleciona-lo o sistema receberá o valor lógico true.

Template Cabeçalho

Ele cria uma área no início da lista de opções exibidas na caixa de seleção utilizando tags de HTML, podendo ser de parágrafo, imagem, etc.

Figura 3 - Configuração e resultado na adição de um template cabeçalho

Template Rodapé

Ele cria uma área no fim da lista de opções exibidas na caixa de seleção utilizando tags de HTML, podendo ser de parágrafo, imagem, etc.

Figura 5 - Configuração e resultado na adição de um template rodapé

Nessa Página

Compatibilidade

Formulário web

Botão do Componente

Imagem no Editor Visual

  • No labels