MultiSelect
O componente MultiSelect permite selecionar múltiplas opções dentro de um ComboBox e a partir das suas seleções é informado o seu respectivos valores.
Propriedades em comum:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Altura | Define a altura do componente | Inteiro | 250 |
| Código | Informa o código gerado pelo Maker ao qual o componente/formulário foi associado. De forma geral, não interfere nas características do componente. | Inteiro | 5 |
| Container | Informa em qual container o componente irá ser inserido. | Indefinido | |
| Dica | Armazena uma dica para o componente, o qual se torna acessível no modo de inserção ou alteração. | Letras | "Digite o CPF do cliente" |
| Habilitado | Torna o componente possível ser editado ou manipulado. | Lógico | Sim |
| PosiçãoX e PosiçãoY | O "X" determina a posição do componente em relação à esquerda do formulário, e o "Y" em relação ao topo. | Inteiro | 100 |
| Tabulação | Indica a ordem de tabulação do componente em relação aos outros que compõem a aba do formulário na qual está posto. Essa ordem pode ser observada quando o usuário altera o estado do formulário/grade para o modo de inclusão ou edição e navega entre os componentes/campos usando a tecla Tab. | Inteiro | 2 |
| Tabular | Selecionando a opção Sim, quando o usuário estiver navegando entre os componentes, como foi descrito no item anterior, o componente receberá foco (observada a ordem de tabulação). | Lógico | Sim |
| Tamanho | Aplicado a todos - determina a largura do componente ou formulário. | Inteiro | 100 |
| Visível | Aplicada a todos os componentes, com exceção da Moldura e do objeto formulário - Selecionando a opção Sim, o componente aparece no formulário. | Lógico | Sim |
| Nome | Aplicada a todos os componentes e para o objeto formulário - apresenta o nome do componente. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar que mais de um componente possua o mesmo nome. | Letras | "Tabela de Consumidores" |
| Descrição | Aplicada a todos os componentes exceto para os componentes Árvore, Grade, Moldura, Imagem e para o objeto formulário - É a legenda que aparece sobre o componente para identificar (resumidamente) qual a sua função. Observação: Ao selecionar um determinado campo o Maker irá sugerir uma descrição obtida no dicionários de dados, caso o usuário deseje deixar o campo da descrição em branco basta apagá-lo e clicar fora do componente. | Letras | "Insira aqui a idade do consumidor" |
Propriedades específicas do componente Multiselect:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Campo | Campo da consulta do formulário que armazenará as referências das seleções | ||
| Fonte de Dados | Condutor de dados para a propriedade Consulta SQL. | ||
| Consulta SQL | Definição de uma consulta SQL. Valor - o valor contido nesta coluna será utilizado para informar os campos representados nas propriedades Campo Chave e Campo Lista. | ||
| Campo Chave | Campo do banco de dados. Valor - o valor contido nesta propriedade será o identificador da opção de listagem. | ||
| Campo Lista | Campo do banco de dados. Valor - o valor contido nesta propriedade será a descritiva da opção de listagem. | ||
| Lista | Uma grade com as colunas: Valor - o valor contido nesta coluna é o valor que será gravado no campo apontado pelo usuário (propriedade Campo do menu suspenso; propriedade Campo, nesse contexto), assim que o usuário selecionar uma das opções no componente; Descrição - o valor contido nessa coluna é o valor que aparece no componente para facilitar a escolha do usuário; | Lista | {{Marcos}{1}} |
| Valor | Esta propriedade possui a mesma função da propriedade descrita pela propriedade Lista. | Lista | {{Marcos}{1}} |
Eventos:
| Evento | Descrição | Parâmetro Automático |
|---|---|---|
| Ao selecionar | Este evento executará o fluxo informado quando uma opção for selecionada. | Valor |
| Ao remover | Este evento executará o fluxo informado quando uma opção for removida. | Valor |
Ambos eventos possuem parâmetro automático. A função associada ao fluxo receberá como primeiro parâmetro a opção selecionada/removida.
Observação:
- A propriedade Consulta SQL quando definida, possuirá prioridade no componente, ignorando as propriedades Lista e Valor.