Gráfico para valores de Tag

Nome

Gráfico

Tecla de atalho

Nenhuma

Ícone

ico

Objeto gráfico

Sim

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

Trend

ico Este objeto permite inserir um componente para plotar valores de Tags em tempo real.

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.

obs 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.

obs Depende

Esquerda

Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.

obs Depende

Largura

Largura, em pixels, do objeto.

obs Depende

Altura

Altura, em pixels, do objeto.

obs 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, 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.

Propriedades do Painel Valores

Propriedade

Descrição

Default

Visível Z1

Habilita ou não a visualização e edição das propriedades do painel de valores

Opções:

  • Sim - Os campos apresentados abaixo nesta tabela serão exibidos.

  • Não - Os campos apresentados abaixo nesta tabela serão ocultados.

Não

Cor de fundo

Z1 Define a cor de fundo do objeto.

00FFFFFFh

Cor da fonte

Z1 Define a cor do texto exibida pelo objeto.

00000000h

Tamanho da fonte

Z1 Define o tamanho da fonte em pixels do texto do objeto.

10

Eixo X: Nome

Z1 Define o nome do eixo das abcissas.

x:

Eixo X: Formato dados

Z1 Formatação do texto para apresentação dos valores no eixo X.

%.2f

Eixo X: Alinhamento Texto

Z1 Define o alinhamento do texto no eixo X.

Opções:

  • Esquerda

  • Direita

  • Centro

Centro

Eixo Y: Nome

Z1 Define o nome do eixo das ordenadas.

y:

Eixo Y: Formato dados

Z1 Formatação do texto para apresentação dos valores no eixo Y.

%.2f

Eixo Y: Alinhamento Texto

Z1 Define o alinhamento do texto no eixo Y.

Opções:

  • Esquerda

  • Direita

  • Centro

Centro

Propriedades do Gráfico

Propriedade

Descrição

Default

Alinhamento

Define o alinhamento do gráfico em relação à sua posição na tela corrente.

Opções:

  • Nenhum- Mantém a posição e tamanho original do gráfico.

  • Parte Superior - Alinhamento do gráfico na parte superior da tela.

  • Parte Inferior - Alinhamento do gráfico na parte inferior da tela.

  • Lateral Esquerda - Alinhamento do gráfico na lateral esquerda da tela.

  • Lateral Direita - Alinhamento do gráfico na lateral direita da tela.

  • Ao Cliente - Alinhamento do gráfico em toda a área da tela.

Tag para ativar atualização

Define o nome do Tag para ativar a atualização do gráfico sempre que o Tag especificado for alterado. Ou seja, quando for especificado um Tag para esta propriedade, sempre que o mesmo sofrer uma alteração de valor, independente do seu valor, será automaticamente realizado uma atualização do gráfico.

Nenhum

Atualização periódica Z2

Define se a atualização de dados do Trend será ou não feita periodicamente.

Opções:

  • Sim - Abre um novo campo chamado “Intervalo de Atualização” para definição do período de atualização.

  • Não - A atualização do objeto não é automaticamente periódica.

Não

Intervalo de Atualização (seg)

Z2 Define o período em segundos de atualização do objeto.

60.00

Título: visível Z3

Define se o título do gráfico será ou não apresentado.

Opções:

  • Sim - É apresentado um novo campo ‘Título: texto’ para definição do título.

  • Não - Não é apresentado título do objeto.

Não

Título: Texto

Z3 Define o texto do título do objeto.

Título

Título: Cor da fonte

Z3 Define a cor do texto do título.

00000000h

Título: Tamanho da fonte

Z3 Define o tamanho em pixels do texto do título.

12

Gráfico: Borda visível

Define quanto a borda do gráfico, se ficará visível ou não.

Sim

Gráfico: Cor da fonte

Define a cor do texto a ser apresentado no gráfico.

00000000h

Gráfico: Tamanho da fonte

Define o tamanho do texto a ser apresentado no gráfico.

10

Gráfico: Cor principal

Define a cor de fundo principal do gráfico. Composta com a propriedade “Gráfico: Cor de fundo” permite utilizar efeito de cor degradê para a cor de fundo do gráfico.

00D8E9ECh

Gráfico: Cor de fundo

Define a cor de fundo secundária do gráfico. Composta com a propriedade “Gráfico: Cor principal” permite utilizar efeito de cor degradê para a cor de fundo do gráfico.

00C8D0D4h

Grid: Visível

Define se o grid interno do gráfico será ou não apresentado.

Opções:

  • Sim -É apresentado o grid do gráfico e apresentado um novo campo ‘Grid: cor’ para definição da cor do grid.

  • Não - Não é apresentado o grid do gráfico

Sim

Grid: Cor

Define a cor do grid do gráfico.

00808080h

Barras rolagem: Visível

Define a apresentação das barras de rolagem do gráfico. As barras de rolagem disponibilizam recursos para navegação sobre o gráfico.

Não

Legenda: Visível

Define a apresentação da legenda do gráfico.

Não

Menu: configuração

Define a apresentação da opção “configuração” no “menu” apresentado quando realizado um clique com o botão direito do mouse sobre o gráfico. Esta opção de “configuração” permite ao usuário da aplicação customizar a apresentação do gráfico, tais como cor de fundo, legenda, etc.

Opções:

  • Sim - Apresenta a opção “configuração” no menu do gráfico.

  • Não - Não apresenta a opção “configuração” no menu do gráfico.

Sim

Janela de Tempo (min) N

Janela de tempo que será apresentado no Trend em minutos.

5.0

obs

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

Propriedades do Eixo X

Propriedade

Descrição

Default

Eixo X: visível Z4

Define a visualização do eixo x (abcissas) no gráfico, considerando a apresentação dos respectivos valores.

Opções:

  • Sim - Apresenta o eixo x. Habilita a configuração das propriedades ‘Eixo X: data hora’ e ‘Eixo X: título’.

  • Não - Não apresenta o eixo x.

Sim

Eixo X: título

Z4 Define o texto do título do eixo x das abcissas do gráfico.

(Nenhum)

Eixo X: data hora

Z4 Define se o valor dos dados obtidos pelo eixo X para as curvas serão convertidos para o usuário no formato de data hora.

Sim

Eixo X: formato dos valores (eixo inferior)

Neste campo é possível configurar o formato do valor do eixo X.

dd/mm/yy hh:nn:ss

Propriedades do Eixo Y

Propriedade

Descrição

Default

Eixo Y: visível Z5

Define a visualização do eixo y (ordenadas) no gráfico, considerando a apresentação dos respectivos valores.

Opções:

  • Sim - Apresenta o eixo y.

  • Não - Não apresenta o eixo y.

Sim

Eixo Y: formato

Neste campo é possível configurar o formato do valor do eixo Y.

##0

Eixo Y: título

Z5 Define o texto do título do eixo das ordenadas do gráfico.

(Nenhum)

Eixo Y: Escala mínima automatica Z6

Define a apresentação da escala mínima para o eixo Y. N

Opções:

  • Sim - A escala mínima do eixo Y é definida automaticamente pelo menor valor apresentado no eixo.

  • Não - Abre uma nova propriedade “Eixo Y: Valor mínimo da escala onde pode ser inserido o valor mínimo desejado para o eixo.

Sim

Eixo Y: Valor mínimo da escala

Z6 Define Valor mínimo para o eixo Y. N

0

Eixo Y: Escala máxima automatica Z1

Define a apresentação da escala máxima para o eixo X. N

Opções:

  • Sim - A escala máxima do eixo Y é definida automaticamente pelo maior valor apresentado no eixo.

  • Não - Abre uma nova propriedade “Eixo Y: Valor máximo da escala onde pode ser inserido o valor máximo desejado para o eixo.

Sim

Eixo Y: valor máximo da escala

Z1 Define Valor máximo para o eixo Y. N

10000

Eixo Y: Habilita scroll

Neste campo é possível configurar se o scroll estará visível, ou não, no gráfico durante a execução da aplicação.

Caso seja selecionado a opção SIM, os campos “Valor de passo do Scroll”, “Limite mínimo para Scroll” e “Limite máximo para Scroll” serão adicionados abaixo deste campo.

Não

Eixo Y: Valor de passo do Scroll

Neste campo é possível configurar de quanto em quanto será o deslocamento do Scroll no eixo Y.

1

Eixo Y: Limite mínimo para Scroll

Neste campo é possível configurar o valor mínimo para o Scroll.

-10

Eixo Y: Limite máximo para Scroll

Neste campo é possível configurar o valor máximo para o Scroll.

20000

Eixo Y: Inverte ordem de exibição de valores

Neste campo é possível configurar se os valores do eixo Y serão apresentados invertidos, ou não.

Não

Eixo Y: Habilita botão de rótulo

Neste campo é possível configurar se o botão de rótulo estará visível no gráfico durante a execução da aplicação.

Não

obs

Estas propriedades estão disponíveis para o HIscada Pro a partir da versão 1.2.07.

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 ClickSeries

Ação a ser executada após o evento de um clique simples sobre uma curva no gráfico. Necessita do nome do script a ser executado. Este campo não é obrigatório.

(Nenhum)

On AfterRefresh

Ação a ser executada após atualização dos dados no gráfico. Necessita do nome do script a ser executado. Este campo não é obrigatório.

(Nenhum)

On ClickYAxis

Ação a ser executada após o evento de um clique simples sobre o eixo Y. Necessita do nome do script a ser executado. Este campo não é obrigatório. Essa propriedade está disponível apenas via script.

(Nenhum)

On ClickButtonLabelYAxis

Ação a ser executada após o evento de um clique simples sobre o botão de rótulo do eixo Y. Essa propriedade está disponível apenas via script

(Nenhum)

TrendPens

ico1 Este item define o grupo de itens que descreverão o formato das curvas do gráfico assim como quais vetores determinarão seus eixos.

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)

TrendPen

ico2 Este item é responsável por organizar uma curva do gráfico. Pode-se com ele determinar o tipo de curva, a cor e quais eixos serão usados para plotar o gráfico. Este item deve ser inserido na árvore de projeto através do item TrendPens.

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)

Descrição

Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.

(Nenhum)

Propriedades Específicas

Propriedade

Descrição

Default

Nome da curva

Define a nomenclatura da curva. Este nome será apresentado no gráfico quando necessário para algumas visualizações e edições.

(Nenhum)

Cor da curva

Define a cor da curva que será apresentada no gráfico. Se a curva for do tipo ponto, os pontos serão da cor definida neste campo.

000000FFh

Tipo da curva

Define o tipo de curva que será apresentada no gráfico.

Opções:

  • Ponto e Linha - Cada ponto representa o cruzamento entre os valores de dois índices iguais dos eixo X e Y. A linha conecta dois pontos consecutivos.

  • Ponto - serão apresentados no gráfico apenas pontos conforme descrito anteriormente.

  • Linha - serão apresentadas as linhas que conectam os pontos descritos anteriormente. Porém, os pontos não são visualizados.

Linha

Tags

Propriedade

Descrição

Default

Nome Tag

Nome do Tag associado ao objeto.

(Nenhum)

Índice

Offset para o valor do Tag associado caso ele seja um vetor.

1

Opções de ação e configuração em tempo de execução

Com o Viewer em execução, pressione com o botão direito do mouse sobre o objeto trend. Ao faze-lo, abrirá uma janela de opções, como na imagem abaixo.

../_images/trend_viewer001.png

Janela de Opções

Opção

Descrição

Atualiza

Força atualização do trend.

Configura

Abre tela de configuração em tempo real do trend.

Imprime

Imprime o gráfico no momento do comando.

Salva BMP

Gera imagem do gráfico no momento do comando.

Copia

Cria uma cópia do gráfico no momento do comando.

Quando selecionado o item configura, abrirá a janela “Configuração das Curvas do Gráfico”. Na janela contém 3 abas:

  • Curvas

  • Gráfico

  • Geral

../_images/trend_viewer002.jpg

Configuração para aba Curvas

Propriedade

Descrição

Nome da curva

Parâmetro não pode ser editado

+/-

Ativa/Desativa a visualização da curva no gráfico.

Cor

Muda a cor da curva no gráfico

-

Muda o tipo da curva no gráfico
../_images/trend_viewer003.png

Configuração para aba Gráfico

Propriedade

Descrição

Gráfico

Configuração para Gráfico:

  • Cor fonte - Muda cor da fonte do gráfico.

  • Cor principal - Degrade para cor principal do gráfico.

  • Cor fundo - Degrade para cor de fundo do gráfico.

Grid

Configuração para Grid:

  • Cor grid - Cor das linhas do grid.

  • Habilitado - Ativa/Desativa visualização das linhas do grid.

Tilulo

Configuração para Tilulo:

  • Cor fonte - Cor do titulo do gráfico.

  • Habilitado - Ativa/Desativa visualização do título do gráfico.

Painel de Valores

Configuração para Painel de Valores:

  • Cor da fonte - Cor da fonte dos valores.

  • Cor de fundo - Cor do fundo do painel de valores.

  • Habilitado - Ativa/Desativa visualização do painel de valores.

Janela de tempo

Configuração para Janela de tempo:

  • Valor da janela(min) - Valor em minutos da janela de tempo.

Atualização periódica

Configuração para Atualização periódica:

  • Habilita - Ativa/Desativa atualização periódica de valores.

  • Intervalo de atualização(seg) - Intervalo de atualização dos valores no gráfico
../_images/trend_viewer004.png

Configuração para aba Geral

Propriedade

Descrição

Legenda

Ativa/desativa visualização das legendas.

Scroll bar

Ativa/desativa visualização das barras de rolagem.

Borda do gráfico

Ativa/desativa visualização das Bordas do gráfico.

Eixo X

Ativa/desativa visualização dos valores do eixo X.

Eixo Y

Ativa/desativa visualização dos valores do eixo Y.

Eixo Y: Escala máxima automática

Ativa/desativa escala máxima automática para eixo Y.

Eixo Y: Valor máximo da escala

Valor máximo para escala do eixo Y do gráfico.

Eixo Y: Escala mínima automática

Ativa/desativa escala mínima automática para eixo Y.

Eixo Y: Valor mínimo da escala

Valor mínimo para escala do eixo Y do gráfico.

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.

Trend

Exemplo de uso do Trend:

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

-- Obtem o nome da tela
local name = scr.Trend_001.Name

-- Obtem distância do topo e esqueda
local top = scr.Trend_001.Top
local left = scr.Trend_001.Left

-- Desloca o topo e esquerda em +10
scr.Trend_001.Top = top+10
scr.Trend_001.Left = left+10

Ver também