Propriedade

Tipo

Valor Padrão

Descrição

text

String

<string vazio>

O texto escolhido pelo usuário e apresentado na interface pelo comboBox.

Observação: Este campo retorna e aceita somente valores que estão na propriedade "items"

value

String

<string vazio>>

O valor associado ao item escolhido e apresentado na interface.

Observação: Este campo retorna e aceita somente valores que estão na propriedade "values".

field

String

<string vazio>

Caminho de um campo no NodeDatabase.

Quando associado, o comboBox passa a apresentar e salvar o conteúdo no campo informado.

Veja também:

• Lua Form e NodeDatabase
• NodeDatabase
• 
  

frameRegion

String

<string vazio>

Considerando que o componente/tag pai possui um frame (ver Frames), ao definir o valor desta propriedade, a posição e tamanho deste controle é automaticamente calculada para se encaixar na Região do Frame de mesmo nome.

Veja Frames e Regiões

transparent

Boolean

false

Quando True, as bordas e o fundo do comboBox não serão exibidas, mostrando apenas o texto conteúdo.

items

Arranjo de String

{}

Lista de itens do qual o usuário poderá escolher um.

Exemplo:

{'Lança', 'Espada', 'Adaga'}

values

Arranjo de String

{}

Lista de valores associados aos itens da propriedade "items".

Cada posição deste arranjo é "casado" com a mesma posição do arranjo "items".

Observação 1: Não é obrigatório o uso desta propriedade;

Observação 2: Quando esta propriedade e o atributo "field" estiverem definidos, este são os valores que serão salvos no NodeDatabase.

Exemplo: {'L', 'E', 'A'}

Método

Descrição

comboBox:dropDown()

"Abre" o comboBox. Exibe a lista de seleção na interface.

Nome do evento

Descrição

onChange

Este evento é invocado quando a seleção do comboBox é alterada.

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">         

        <comboBox left="20" top="20" items="{'Lança', 'Espada', 'Adaga'}"/>
</form>

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">         

        <comboBox left="20" top="20" items="{'Lança', 'Espada', 'Adaga'}"
                  values="{'L', 'E', 'A'}" value="E"/>
</form>