Função

A caixa de seleção fixa é um componente do tipo combobox e seus itens são alimentados manualmente nas configurações do componente. Normalmente é utilizado em situações onde há necessidade de exibir uma pequena 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 facilitar a seleção pelo usuário.

Figura 1.1 - Exemplo do componente rodando no browser

Principais propriedades

Na tabela abaixo estão descritas as principais propriedades para o funcionamento básico do componente.

Configuração

A janela Configuração possui diversas propriedades para a personalização do componente. Selecione o componente no editor visual para exibir suas propriedades na aba lateral, clique no botão “...” da propriedade Configuração para abrir a janela.

Aba Geral

Figura 2.1 - Janela de configuração

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

• Placeholder: exibe um texto exemplo antes do usuário selecionar uma opção, mas seu uso é opcional;

• Tipo Filtro: define a forma de pesquisa da lista de opções:

  • Contendo: mostra as opções que contêm a sequência das letras digitadas;

  • Iniciando com: mostra as opções que comecem com a sequência das letras digitadas;

  • Final com: mostra as opções que terminem com a sequência das letras digitadas;

• Campo Chave: define o identificador de retorno do item selecionado pelo usuário;

• Campo Texto: define o conteúdo que será mostrado na caixa de seleção para o usuário.

1. Editar: abre uma janela para fazer a edição do item;

2. Excluir: exclui o item.

• Usar Template Personalizado: ao selecionar, uma nova abas é exibida para personalizar o texto listado.

Aba cabeçalho

Na aba cabeçalho é possível adicionar texto ou tags do HTML - podendo ser de parágrafo, imagem, entre outros (Figura 2.2) - e, assim, criar uma área no início da lista de opções exibidas pelo componente (Figura 2.3).

Image Removed

2).

Figura 2.3 - Área do cabeçalho ao executar componente  Configuração e resultado no browser da aba cabeçalho

Aba rodapé

Na aba rodapé é possível adicionar texto ou tags do HTML - podendo ser de parágrafo, imagem, entre outros (Figura 2.4) - e, assim, criar uma área no início da lista de opções exibidas pelo componente (Figura 2.54).

Figura 2.5 - Área do rodapé ao executar componente no browser4 - Configuração e resultado no browser da aba rodapé

Aba Elementos

Essa aba permite formatar a apresentação das opções quando o usuário abrir a caixa de seleção fixa.

É possível inserir qualquer caractere antes ou depois das chaves #: data.value # e #: data.key #, ao abrir a caixa de seleção, os caracteres serão exibidos junto com as opções do Campo Valor e/ou chave.

Image Removed

chave

Image Removed

.