Shape

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

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

Shape

Este objeto permite inserir uma forma geométrica.

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)
Título	Neste campo é possível definir um título para este objeto.	Depende
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, Altura e Título tem seus valores default definidos no momento da criação do objeto. Então, esses valores podem variar para os diferentes tipos de objeto.

Proprieades Específicas
Propriedade	Descrição	Default
Espessura do Contorno	Define a largura da linha de contorno da forma geométrica inserida.	1
Cor do Contorno	Define a cor da linha de contorno da forma geométrica.	00000000h
Estilo do contorno	Define como será o tipo da linha de contorno. Opções: Sólido Traço Ponto Traço ponto Traço ponto ponto Clear	Sólido
Cor do preenchimento	Define a cor do preenchimento da forma geométrica.	00FFFFFFh
Estilo do preenchimento	Define o estilo de preenchimento da forma geométrica. Opções: Sólido Cruz Clear BDiagonal Horizontal FDiagonal Vertical Diagonal Vertical	Sólido
Formato da forma	Altera a forma geométrica. Opções: Circulo Elipse Retângulo Retângulo arredondado Quadrado arredondado Quadrado	Retângulo

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)

---

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.

Shape

Shape
Propriedades Específicas	Descrição
Shape	Através desta propriedade pode-se selecionar uma forma da figura geométrica para apresentação. Parâmetro Somente Leitura

Pen

Pen
Propriedades Específicas	Descrição
Pen.Style	Através desta propriedade pode-se selecionar um estilo de borda para apresentação. Parâmetro Somente Leitura
Pen.Color	Através desta propriedade pode-se selecionar a cor da borda para apresentação.
Pen.Size	Através desta propriedade pode-se selecionar o espessura da borda para apresentação.

Brush

Brush
Propriedades Específicas	Descrição
Brush.Style	Através desta propriedade pode-se selecionar um estilo de preenchimento para apresentação. Parâmetro Somente Leitura
Brush.Color	Através desta propriedade pode-se selecionar a cor de preenchimento para apresentação.

Exemplo de uso do Shape:

-- Obtem tela atual
local scr = Screens.Get('Screen_001')

local pen_color = scr.Shape_001.Pen.Color
local pen_width = scr.Shape_001.Pen.Width

local brush_color = scr.Shape_001.Brush.Color

scr.Shape_001.Pen.Color = 0xff0000 -- Azul
scr.Shape_001.Pen.Width = 10

scr.Shape_001.Brush.Color = 0xff0000 -- Azul

Ver também

• Telas Sinópticas

• Lista completa dos objetos de tela