Combo Box
Uma caixa de combinação é semelhante a uma [lista suspensa] (dropdownList_Overview.md#overview), exceto pelo fato de que ela aceita texto digitado pelo teclado e tem opções adicionais.
Em outros aspectos, você deve tratar uma combo box como uma área editável que usa seu array ou uma lista de escolha como um conjunto de valores padrão.
Gestão do combo boxes
Use o evento [On Data Change] (Events/onDataChange.md) para gerenciar as entradas na área de entrada, como faria com qualquer objeto de formulário de entrada.
Você inicializa uma caixa de combinação exatamente da mesma forma que uma [lista suspensa] (dropdownList_Overview.md#overview): usando um objeto, uma matriz ou uma lista de opções.
Utilização de um objecto
Esta funcionalidade só está disponível em projectos 4D.
Um objeto encapsulando uma coleção pode ser usado como a fonte de dados de uma caixa de combinação. O objeto deve conter as seguintes propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
valores | Collection | Obrigatório - Coleção de valores escalares. Todos os valores devem ser do mesmo tipo. Tipos suportados |
currentValue | igual a Colecção | Texto introduzido pelo usuário |
Se o objeto contiver outras propriedades, estas são ignoradas.
Quando o usuário insere um texto na caixa de combinação, a propriedade currentValue do objeto obtém o texto inserido.
Usar um array
Consulte Usando uma matriz na [página da lista suspensa] (dropdownList_Overview.md#using-an-array) para obter informações sobre como inicializar a matriz.
Um combo box é iniciado em exatamente da mesma forma que uma lista drop down Se o usuário digitar texto em uma combo box, preenche o 0imo elemento do array.
Utilizar uma lista de seleção
If you want to use a combo box to manage the values of an input area (listed field or variable), 4D lets you reference the field or variable directly as the form object's data source. Isso facilita gerenciar variáveis/campos listados.
Se usar uma lista hierárquica, só o primeiro nível é mostrado e pode ser selecionado.
Para associar uma caixa de combinação a um campo ou variável, basta digitar o nome do campo ou da variável diretamente em [Variable or Expression] (properties_Object.md#variable-or-expression) do objeto do formulário na Lista de propriedades.
When the form is executed, 4D automatically manages the combo box during input or display: when a user chooses a value, it is saved in the field; this field value is shown in the combo box when the form is displayed:
Consulte Usando uma escolha na página [lista suspensa] (dropdownList_Overview.md#using-a-choice-list) para obter mais informações.
Opções
Objetos do tipo combo box aceitam duas opções específicas referentes a listas de escolhas associadas com elas:
- Inserção automática: permite adicionar automaticamente um valor à fonte de dados quando um usuário insere um valor que não é encontrado na lista associada à caixa de combinação.
- Excluded List (lista de valores excluídos): permite definir uma lista cujos valores não podem ser inseridos na caixa de combinação. Se um valor excluído for digitado, não será aceito e uma mensagem de erro é exibido.
A associação de uma [lista de valores obrigatórios] (properties_RangeOfValues.md#required-list) não está disponível para caixas de combinação. Em uma interface, se um objeto precisar propor uma lista finita de valores necessários, você deverá usar um objeto [drop-down list] (dropdownList_Overview.md#overview).
Propriedades compatíveis
Alpha Format - Bold - Bottom - Choice List - Class - Date Format - Expression Type - Font - Font Color - Font Size - Height - Help Tip - Horizontal Sizing - Italic - Left - Object Name - Right - Time Format - Top - Type - Underline - Variable or Expression - Vertical Sizing - Visibility - Width