Tag comboBox¶

A tag/componente comboBox representa uma caixa de seleção que permite o usuário selecionar um item entre vários..

Herança¶

O comboBox possui todas as características de uma tag de texto. Veja:

Características¶

Além das características herdadas, a tag comboBox também possui as seguintes características:

Propriedades e atributos¶

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étodos¶

Método	Descrição
comboBox:dropDown()	"Abre" o comboBox. Exibe a lista de seleção na interface.

Eventos¶

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

Veja Tratando eventos do Lua Form

Exemplos¶

Exemplo 1 - comboBox simples¶

\<?xml version="1.0" encoding="UTF-8"?> \<form name="frmFichaTeste"> \<comboBox left="20" top="20" items="{'Lança', 'Espada', 'Adaga'}"/> \</form>

Exemplo 2 - comboBox usando a propriedade "values" para escolha do item padrão.¶

\<?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>

Neste exemplo, devido as propriedades "items" e "values", houve a associação dos seguintes valores e itens:

L = Lança
E = Espada
A = Adaga

Created with the Personal Edition of HelpNDoc: Elevate your documentation to new heights with HelpNDoc's built-in SEO