Grid

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

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

Grid

ico Este objeto de tela permite a visualização de vários Tags simultaneamente através de uma tabela.

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

Tabela de Dados

Define uma referência a um item do tipo TableTag, que contém as referências aos tags cujos valores serão visualizados na tabela.

Mostra título da coluna

Define se os títulos das colunas da tabela selecionada serão ou não apresentados.

Sim

Nro. de colunas fixas

Define a quantidade de colunas (a partir do lado esquerdo) da tabela que ficarão posicionadas fixamente, sem a possibilidade de troca de posição.

0

Cor do título

Define a cor de fundo das colunas de títulos a serem apresentados no grid.

00C0C0C0h

Altura da linha

Define a altura em pixels de cada linha linha do grid

20

Propriedades da fonte

Abre tela para definições das propriedades da fonte.

Arial,10,Preto

Cor do cursor

Define a cor do separador de linhas quando o foco está em uma linha selecionada dentro do grid.

000000FFh

Cor inicial linha par

Define a cor inicial das linhas pares do grid.

RGB(255,0,0)

Cor final linha par

Define a cor final das linhas pares do grid.

RGB(238,238,174)

Cor inicial linha ímpar

Define a cor inicial das linhas ímpares do grid.

RGB(238,238,254)

Cor final linha ímpar

Define a cor final das linhas ímpares do grid.

RGB(255,255,255)

obs

Este evento está disponível para o HIscada Pro a partir da versão 1.3.00.

Eventos
Propriedade	Descrição	Default
On Click	Ação a ser executada 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	Ação a ser executada após o evento de um clique duplo sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório.	(Nenhum)

GridFormatConditions

ico1 Item que determina um grupo para organização dos itens que definem condições de formatação do objeto Grid.

Identificação
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)

GridFormatCondition

ico2 Este item determina propriedades de formatação do objeto Grid, segundo a definição de um script. É um subitem do item GridFormatConditions, e deve ser adicionado para ser apresentado.

Identificação
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)

Propriedades Específicas
Propriedade	Descrição	Default
Coluna associada	Define a coluna para a qual o “GridFormatCondition” estará associado. Esse parâmetro depende diretamente de cada GridColumn existente no grid. Para a opção “Todas(Linha)”, a condição definida no GridFormatCondition é associada a todas as colunas do grid.	Todas(Linha)
Script da condição	Permite a edição do script associado ao “GridFormatCondition” onde são definidas as condições para aplicar as formatações no grid.	(Nenhum)
Formata cor da fonte	Permite a formatação da cor da fonte. Opções: Sim - Habilita a formatação da cor da fonte, quando selecionado apresenta um novo campo para definição da cor. Não - Desabilita a formatação da cor da fonte.	Não
Cor da fonte	Define a cor da fonte a ser exibida no caso de a condição definida no Script de condição ocorrer.	00000000h
Formata cor de fundo	Permite a formatação da cor de fundo. Opções: Sim - Habilita a formatação da cor de fundo, quando selecionado apresenta um novo campo para definição da cor. Não - Desabilita a formatação da cor de fundo.	Não
Cor de fundo	Define a cor de fundo a ser exibida no caso de a condição definida no Script de condição ocorrer.	00000000h
Formata estilo da fonte	Permite a formatação do estilo da fonte. Opções: Sim - Habilita a formatação da cor de fundo, quando selecionado apresenta um novo campo para definição da cor. Não - Desabilita a formatação da cor de fundo.	Não
Estilo da Fonte	Define o estilo da fonte a ser exibida no caso de a condição definida no Script de condição ocorrer. Opções: Negrito Itálico Sublinhado Tachado	Negrito

GridColumns

ico3 Item que define um grupo para organização de colunas do objeto Grid.

Identificação
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)

GridColumn

ico4 Este item define as propriedades de uma coluna do objeto Grid. É um subitem do item GridColumns, e deve ser adicionado para ser apresentado.

Identificação
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)

Propriedades Específicas
Propriedade	Descrição	Default
Coluna da tabela	Neste campo é possível selecionar uma coluna da tabela associada ao Grid. Este campo só admite definição caso seja criada uma Tabelas com pelo menos uma coluna e que esta tabela seja referenciada na propriedade Tabela de dados do objeto “Grid”.	(Nenhuma)
Título da coluna	Define o texto de título que será apresentado na parte superior desta mesma coluna.	GridColumn_NNN
Habilitada	Define se a coluna estará habilitada, ou não.	Sim
Alinhamento do texto	Define o alinhamento do texto de cada campo da coluna. Opções: Esquerda Direita Centro	Centro
Formato de apresentação	Define como cada Tag será apresentado. Opções: Padrão Lista de texto - Será apresentado um texto dependente da definição da Lista de texto associada. Lista de imagens - Será apresentada uma imagem dependente da definição da Lista de imagem associada. Texto formatado - Apresentam-se os Tags de acordo com a formatação especificada no campo Formato do texto. Valor ponto flutuante - Apresentam-se os Tags em formato de ponto flutuante com formatação definida no campo Formato do texto. Valor inteiro - Apresentam-se os Tags em formato de número inteiro com formatação definida no campo Formato do texto. Valor por script - O valor é definido pelo retorno de um script lua On Column Format.	Padrão
Lista de texto	Se a propriedade “Formato de apresentação” possui o valor “Lista de texto”, define-se neste campo o nome da lista de texto associada.	(Nenhuma)
Lista de imagem	Se a propriedade “Formato de apresentação” possui o valor “Lista de imagem”, define-se neste campo o nome da lista de imagem associada	(Nenhuma)
Formato do texto	Se a propriedade “Formato de apresentação” possui o valor “Texto formatado”, ou “Valor ponto flutuante”, ou “Valor inteiro” define-se neste campo a formatação de apresentação do valor do Tag associado à célula.	(Nenhum)
On Column Format	Se a propriedade “Formato de apresentação” possui o valor “Valor por script”, define-se neste campo o script a ser executado antes da apresentação do valor.Consultar Evento: OnGridColumnFormatValue para outras informações sobre a sintaxe deste evento.	(Nenhum)
Força filtro inicial	Permite especificar um filtro inicial para a coluna do grid.	Não
Filtro inicial	Se a propriedade “Força filtro inicial” está habilitada, define neste campo o respectivo filtro inicial a ser aplicado à coluna do grid.	(Nenhum)
Habilita cor de fundo	Permite ou não definir uma única cor de fundo da coluna. Opções: Sim - Habilita novo campo Cor de Fundo, permitindo a seleção de uma cor de fundo para a coluna. Não A cor de fundo será definida como apresentado no campo de propriedades Específicas do Grid.	Não
Cor de fundo	Se a propriedade “Habilita cor de fundo” está habilitada, permite definir a cor de fundo da coluna.	00FFFFFFh

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.

Grid

Grid
Propriedades Específicas	Descrição
ColCount	número de colunas do Grid.
RowCount	número de linhas do Grid.

Grid
Funções Específicas	Descrição
GetCellText(linha,coluna)	Recebe como parâmetro linha e coluna e retorna o texto da célula.
GetCellTag(linha,coluna)	Recebe como parâmetro linha e coluna e retorna o Tag associado à célula.

obs

Observação

Os parâmetros linha e coluna utilizados nas funções GetCellText e GetCellTag iniciam-se em zero. Por exemplo, para acessar o texto da célula da terceira linha e segunda coluna a chamada será GetCellText(2,1).

As células presentes na primeira linha retornarão ‘nil’ na função GetCellTag se o título das colunas estiver habilitado.

Exemplo de uso do Grid:

--este exemplo considera a existência de um grid de nome Grid_001 na tela (Sender) contendo no mínimo 3 linhas (além da linha de título) e 3 colunas

-- Obtem tela atual
local scr = Sender.Screen
--imprime valor em forma de texto de todas as células
for Row = 1, 3 do
        for Col = 0, 2 do
                print("Texto da Célula: (" .. Row .. "," .. Col .. ")" .. scr.Grid_001:GetCellText(Row,Col))
                local tag = scr.Grid_001:GetCellTag(Row,Col)
                print("Nome do Tag: " .. tag.Name)
        end
end

Ver também