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
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.
Abrir o projeto do Action.Net onde o controle serĆ” utilizado;
Na aba āDrawā, escolher a pĆ”gina onde o controle serĆ” utilizado;
Na barra lateral de ferramentas, escolher o item āInsert Componentā;
Ao abrir a tela de seleĆ§Ć£o de componentes, selecionar o controle BarAndSplineCustomChart;
Inserir o controle na tela e dimensionĆ”-lo.
Selecionar o controle e inserir um Uid para o mesmo. Ć este que serĆ” utilizado no code-behind para passar os dados ao grĆ”fico.
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:
Ā