Grid de valores do DB

Nome	DB Grid
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Sim

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

DBGrid

Este objeto permite a visualização dos dados do DataBase através de uma representação tabular.

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

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á apresentado pelo objeto grid.	(Nenhuma)
Aplica alterações automaticamente	Define se as alterações realizadas no campo do DataSource associado ao objeto, serão aplicadas automaticamente no DataBase.	Não
Ajusta largura das colunas automaticamente ao texto	Define se a largura das colunas do grid vão se ajustar ao texto do dado, mostrando toda a informação ou sobreponto a mesma, mostrando um grid com largura reduzida.	Não
Ajusta largura da última coluna ao tamanho do objeto	Define se a largura da última coluna do grid vai se ajustar ao tamanho limite definido para o grid na criação do objeto, ou seja, a última coluna vai alcançar o lado direito do grid, ocupando o espaço do objeto por completo.	Não
Somente leitura	Define se as colunas do grid vão permitir alterações de inserção, modificação e remoção dos dados persistidos no grid.	Não
Permite ordenação pelo clique nas colunas	Define se a ordenação dos dados pode ser feita clicando no atributo identificador do dado no topo de uma coluna. A ordenação pode ser feita por qualquer coluna, mas apenas uma por vez.	Não
Seleção de múltiplas linhas	Define se múltiplas linhas do grid podem ser selecionadas ao mesmo tempo. Sendo o campo habilitado, aperte Ctrl e clique sobre as linhas desejadas.	Não

Propriedades de Aparência do Grid
Propriedade	Descrição	Default
Largura da linha de título	Define a largura do campo dos atributos identificadores no topo das colunas.	20
Largura das linhas	Define a largura das linhas do grid onde os dados são exibidos.	20
Exibe indicador de registro selecionado	Define se o indicador de registro, situado no canto esquerdo do grid, deve ser apresentado ao lado do dado selecionado ou não.	Sim
Exibe marcação de separação de linhas	Define se as linhas de saparação entre dados e atributos deve ser apresentada ou não.	Sim
Exibe marcação de separação de colunas	Define se as linhas verticais que separam as informações entre as colunas serão exibidas ou não.	Sim
Exibe linhas com cores alternadas	Define se os dados no grid serão apresentados em linhas intercaladas,isso é,onde a cor de fundo das linhas tem coloração diferente. (Branco/Cinza)	Sim
Fonte das colunas de título	Define o formato, tamanho e cor da fonte exibida nos títulos das colunas.	Default

Eventos
Propriedade	Descrição	Default
On Click	Executa uma ação após o evento de um clique simples sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório.	(Nenhum)
On Double Click	Executa uma ação após o evento de um duplo clique sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório.	(Nenhum)

---

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.

DBGrid

DBGrid
Funções Específicas	Descrição
GetColumnValuesFromName	Função que permite recuperar os valores de uma coluna do DBGrid em uma variável lua do tipo tabela.

Exemplo de uso de DBGrid

GetColumnValuesFromName

-- Para recuperar os valores de uma Coluna do DBGrid, primeiro devemos obter o objeto de tela associado ao DBGrid.
-- scr é uma variável local que referncia o objeto de tela corrente, onde o DBGrid esta instanciado
local scr = Screens.Get("Screen_001")
-- Com a variável de referência à tela, podemos acessar todos seus objetos. Neste caso, o DBGrid:
local dbgrid = scr.DBGrid_001
-- Finalmente, podemos utilizar a função para recuperar os valores de uma dada coluna do DBGrid
-- funcao GetColumnValuesFromName()
-- Parâmetro 1 : Nome da coluna do DBGrid onde sera feita a recuperação dos valores (string)
-- Parâmetro 2 : Valor que especifica se a função deve retornar os valores de todas as células ou apenas da
--               célula selecionada
--   - Se valor_booleano = 0, função retorna todos os valores das células
--   - Se valor_booleano = 1, função retorna o valor da célula selecionada
-- Exemplo: valores = dbgrid.GetColumnValuesFromName('nome_coluna', valor_booleano)
valores = dbgrid.GetColumnValuesFromName('id_pessoa', 0)

Ver também

• Telas Sinópticas

• Lista completa dos objetos de tela