BarAndSplineCustomChart

Este controle WPF foi desenvolvido com o intuito de apresentar um gráfico de barras com linha.

 

Apresentação

O controle BarAndSplineCustomChart é um gráfico customizado desenvolvido para apresentar valores de histórico de uma determinada tag no formato de colunas e com linha que toca os valores de histórico no gráfico.

 

 

Como usar

Requisitos mínimos

  • Action.Net versão 9.2.28.1 ou posterior;

Configuração

  1. Inserir o arquivo “SPIN.ActionNet.View.Wpf.Charts.dll” na pasta WpfControls da instalação (normalmente em “C:\Program Files (x86)\SPIN\Action.Net\an-x.x\WpfControls\”) caso o mesmo não exista.

  2. Abrir o projeto do Action.Net onde o controle será utilizado;

  3. Na aba “Draw”, escolher a página onde o controle será utilizado;

  4. Na barra lateral de ferramentas, escolher o item “Insert Component”;

  5. Ao abrir a tela de seleção de componentes, selecionar o controle BarAndSplineCustomChart;

  6. Inserir o controle na tela e dimensioná-lo.

  7. Selecionar o controle e inserir um Uid para o mesmo. É este que será utilizado no code-behind para passar os dados ao gráfico.

  8. Configurar o código no code-behind da tela:

Inicialmente, é necessário acessar o controle a partir do seu Uid. Para pegar uma referência do controle para utilizá-lo, utilize o script a seguir:

Em seguida, os dados precisam ser passados para o controle. O mesmo dispõe de uma função para a passagem dos dados a partir de um datatable para o controle. Sua assinatura pode ser conferida abaixo:

Onde:

tagName: refere-se ao tag de pesquisa. Este parâmetro é usado para o Header do gráfico.

histValues: refere-se a uma tabela cujo formato consiste na primeira coluna com valores compatíveis com o tipo DateTime e a segunda coluna com valores compatíveis com os tipos float ou double.

Esta função pode ser chamada de como mostrado abaixo:

 

Atenção: É extremamente importante que a tabela siga o formato esperado com duas colunas, sendo:

  • Primeira coluna com valores compatíveis com o tipo DateTime; e

  • Segunda coluna com valores compatíveis com os tipos float ou double.

Tabelas não compatíveis com este formato podem trazer consequências inesperadas ao gráfico.

 

Esta aplicação específica do exemplo utilizou o Spin toolkit para pesquisa de medidas de um determinado período (últimos 10 dias). O código completo para esta aplicação pode ser verificado abaixo:

Membros de BarAndSplineCustomChart

No controle foram expostas aos usuários algumas propriedades e métodos para uso do gráfico. Nas tabelas a seguir, é possível visualizar os nomes das propriedades e dos métodos e suas descrições:

Propriedades

Nome

Descrição

TagName

Nome da tag a qual o gráfico se refere. Este nome será mostrado no cabeçalho do gráfico

HistValues

Lista observável de objetos do tipo HistorianValues que contém informações de valor e Timestamp da tag

XAxisLabelFormat

Corresponde ao formato do texto desejado para o label do eixo X. Este é o eixo de data / hora.

O formato padrão para esta propriedade é “MMM-dd HH:mm”.

XAxisLabelRotationAngle

Corresponde ao ângulo de rotação desejado para o label do eixo X. Deve-se passar valores de -360 a 360.

YAxisLabelFormat

Corresponde ao formato do texto desejado para o label do eixo Y. Este é o Eixo de valores.

O formato padrão para esta propriedade é “N0”.

YAxisLabelRotationAngle

Corresponde ao ângulo de rotação desejado para o label do eixo Y. Deve-se passar valores de -360 a 360.

Métodos

Nome

Descrição

ApplyHistorianData(string, DataTable)

Método que transforma os parâmetros passados em linhas e colunas do gráfico e aplica estas informações ao gráfico.

Parâmetros

tagName: refere-se ao tag de pesquisa. Este parâmetro é usado para o Header do gráfico.

histValues: refere-se a uma tabela cujo formato consiste na primeira coluna com valores compatíveis com o tipo DateTime e a segunda coluna com valores compatíveis com os tipos float ou double

Nesta página: