4D Doc Center : Combo Boxes

4D v14.3

Combo Boxes

Um combo box é similar a uma lista suspensa, exceto pelo fato de que o objeto aceita a entrada de texto pelo usuário e que dispõe de duas opções específicas.. Um combo box é inicializado da mesma forma que uma lista suspensa (ver Menus suspensos/Listas suspensas).

Se o usuário introduz texto no combo box, preenche-se o elemento 0 do array. Em outras palavras, deve considerar o combo box como uma zona editável que utiliza um array como um conjunto de valores padrão.

Utilize o evento On Data Change para manejar os valores de entrada para a área editável, assim como você utilizaria um objeto da área editável. Para mais informação, consulte a descrição do comando Form event no manual de Linguagem de 4D.

Opções de combo box

Os objetos de tipo Combo box aceitam duas opções relativas as listas de seleção associadas a eles: Inserção automática e Exclusões (lista de valores excluídos).

Inserção automática

A opção Inserção automática se encontra no tema "Fonte de dados" da Lista de propriedades para os objetos de tipo combo box:

Nota: esta opção também está disponível para as colunas do quadro de lista, já que suas células são mostra como quadros combinados quando uma coluna está associado com uma lista de seleção.

Quando se ativa esta opção, se um usuário introduz um valor que não se encontra na lista de seleção associada ao objeto, este valor se adicione automaticamente a lista armazenada na memória. Pode associar listas de seleção utilizando o comando OBJECT SET LIST BY NAME ou OBJECT SET LIST BY REFERENCE.

Por exemplo, dada uma lista de opção é associada ao combo box "País" e contém "França, Alemanha, Itália”. Se o usuário introduz "Espanha" e se a opção Inserção Automática está selecionada, o valor "Espanha" se adicione automaticamente a lista na memória:

Naturalmente, o valor introduzido não deve pertencer a lista de valores excluídos associados ao objeto, se foi definido (ver o seguinte parágrafo).

Nota: se a lista é criado a partir de uma lista definida no modo Desenho, a lista original não se modifica.

Se a opção Inserção automática não está selecionada, o valor introduzido se armazena no objeto, mas não na lista em memória.

Lista de excluídos

A opção Lista de excluídos se oferece no tema "Rango de valores" dos objetos de tipo combo box, permitindo associar uma lista de valores excluídos a estes objetos. Se o usuário introduz um valor que pertence a esta lista, sua entrada se rejeita automaticamente (ver Lista de valores excluídos).

Nota: a possibilidade de associar uma lista de valores obrigatórios não está disponível para os combo boxes. Em uma interface, se um objeto deve propor uma lista finita de valores obrigatórios, então deve utilizar um objeto de tipo de lista deslocável.