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:

Ā