Caixa de seleção para dados do DB

Nome	DB Lookup Combo Box
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Sim

Esta página apresenta a descrição e propriedades do item DBLookupComboBox.

DBLookupComboBox

ico Este objeto permite a visualização e seleção dos dados de um DataSource, através de um ComboBox de seleção.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Argumentos	Neste campo pode-se inserir uma string que será o valor da propriedade Argument do item. A string fornecida é uma forma geral de passagem de parâmetros para os scripts associados ao objeto durante sua execução.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
Descrição	Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental não sendo utilizado no projeto. Este campo não é obrigatório.	(Nenhuma)
Dica	Texto a ser apresentado quando o mouse é posicionado sobre o objeto. Este campo não é obrigatório.	(Nenhuma)
Topo	Define a distância, em pixels, entre a borda superior do objeto e a borda superior da tela.	Depende
Esquerda	Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.	Depende
Largura	Largura, em pixels, do objeto.	Depende
Altura	Altura, em pixels, do objeto.	Depende
Habilitado	Define se o objeto pode responder a interação do usuário.	Sim
Grupo com permissão de execução	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar a imagem na tela da aplicação.	Todos os grupos
Visível	Define se o objeto será ou não exibido na tela.	Sim
Grupo com permissão de visualização	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar imagem na tela da aplicação.	Todos os grupos

obs

As propriedades Topo, Esquerda, Largura e Altura tem seus valores default definidos no momento da criação do objeto. Então, esses valores podem variar para os diferentes tipos de objeto.

Propriedades Específicas
Propriedade	Descrição	Default
Data Source	Define o DataSource (previamente criado) que será utilizado pelo objeto ComboBox.	(Nenhuma)
Campo(field) a ser listado do Data Source	Define qual coluna, ou seja, conteúdo da coluna do DataSource que será apresentado no menu de seleção do ComboBox.	Sem Data Source Definido
Campo(field) de índice do Data Source	Define no ComboBox o índice associado ao campo a ser listado, selecionado do Data Source anteriormente. É obrigatório o preenchimento desse campo para associar um id (ou chave) ao valor (ou texto) exibido na caixa de seleção.	Sem Data Source Definido
Altera valor de outro campo na seleção	Define se valor de outro campo será modificado quando selecionado um item do Combo Box. Quando habilitado, abre e permite edição das próximas quatro propriedades .	Não
Data Source	Define em qual DataSource o campo será modificado quando selecionado um item do ComboBox (Habilitado somente quando a propriedade “Altera valor de outro campo na seleção” está Habilitada).	(Nenhuma)
Campo(field) do Data Source	Define o campo, correspondente no DataSource, que deve ser alterado após a seleção de um item no menu ComboBox. (Habilitado somente quando a propriedade “Altera valor de outro campo na seleção” está Habilitada).	Sem Data Source Definido
Valor a ser utilizado	Define o valor que será inserido no campo do DataSource que definimos na propriedade anterior como alvo da alteração. (Habilitado somente quando a propriedade “Altera valor de outro campo na seleção” está Habilitada).	Texto Selecionado
Aplica alterações Automaticamente	Define se as alterações realizadas no campo do Data Source associado ao objeto, serão aplicadas automaticamente no Data Base.(Habilitado somente quando a propriedade “Altera valor de outro campo na seleção” está Habilitada).	Não
Propriedades da Fonte	Define as propriedades do texto exibido no campo do ComboBox. (Fonte de texto).	Default

API Lua

A lista das propriedades e atributos deste e outros componentes estão documentadas em Scripts e Acesso a atributos e funções de Componentes de Tela. A seguir apresentamos as tabelas com as propriedades e atributos de gerenciamento que podem ser utilizados via scripts, para o objeto descrito nessa página:

Atributos Comuns

São apresentados neste item os atributos que são comuns à grande maioria dos componentes de tela.

Atributos Comuns
Nome da Propriedade	Descrição
Visible	Torna o componente visível ou não.
Enabled	Habilita ou não a interação com o componente.
Top	Distância em pixels do topo do componente ao topo da tela em que está contido.
Left	Distância em pixels da lateral esquerda do componente à lateral esquerda da tela em que está contido.
Width	Largura em pixels do componente.
Height	Altura em pixels do componente.
Arguments	Texto preenchido no IDE na propriedade Argumentos.

DBLookupComboBox

DBLookupComboBox
Propriedades Específicas	Descrição
KeyValue	Retorna o valor de índice associado ao item selecionado no DBLookupComboBox.
Text	Retorna o texto do item selecionado no DBLookupComboBox.

Exemplo de uso do DBLookupComboBox

-- Sender.Screen.DBLookupComboBox_001.KeyValue é o caminho para se acessar o KeyValue de um item
-- selecionado no DBLookupComboBox. O mesmo vale para acessar o texto, porém colocamos Text no
-- lugar de KeyValue.
print(Sender.Screen.DBLookupComboBox_001.KeyValue)
print(Sender.Screen.DBLookupComboBox_001.Text)
-- Também é possível atribuir um valor ao KeyValue, para que se possa retornar o texto desejado
-- associado ao valor , fazendo:
local defined = Sender.Screen.DBLookupComboBox_001
-- O valor indexado ao texto deve existir para evitar problemas
defined.KeyValue = 5
print(defined.Text) -- O Texto exibido será o que estiver associado ao indice 5

Ver também