Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

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.

Image Removed

Como usar

Requisitos mínimos

Action.Net versão

This WPF control was developed in order to present a line bar chart.

Presentation

The BarAndSplineCustomChart control is a custom chart designed to display history values for a given tag in column format and with a row that touches the history values on the chart.

Image Added

How to use

Minimum requirements

  • Action.Net version 9.2.28.1 ou posterioror later;

Configuração

Inserir o arquivo “SPIN

Configuration

  1. Insert the file "SPIN. ActionNet.View.Wpf.Charts.

dll” na pasta WpfControls da instalação (normalmente em “C
  1. dll" in the WpfControls folder of the installation (typically in "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”;

    Image Removed
  • Ao abrir a tela de seleção de componentes, selecionar o controle BarAndSplineCustomChart;

    Image Removed
  • 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
    1. ") if it does not exist.

    2. Open the project of the Action.Net where the control will be used;

    3. In the "Draw" tab, choose the page where the control will be used;

    4. In the toolbar, choose the item "Insert Component";

      Image Added
    5. When you open the component selection screen, select the BarAndSplineCustomChart control;

      Image Added
    6. Insert the control on the screen and scale it.

    7. Select the control and enter a Uid for it. This is what will be used in the code-behind to pass the data to the graph.

    8. Configure the code in the screen code-behind:

    Initially, it is necessary to access the control from your Uid. To get a reference from the control to use it, use the following script:

    Paste code macro
    languagecs
    SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart barAndSplineCustomChart1 = 
    		this.CurrentDisplay.GetControl("barAndSplineCustomChart1") as SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart;
    		
    if(barAndSplineCustomChart1 != null){
    
    //... code goes here
    
    }

    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 abaixoThen the data needs to be passed to the control. It has a function for passing data from a datatable to the control. Your signature can be checked below:

    Paste code macro
    languagecs
    public void ApplyHistorianData(string tagName, DataTable histValues){}

    OndeWhere:

    tagName:

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

    refers to the search tag. This parameter is used for the Chart Header.

    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 abaixorefers to a table whose format consists of the first column with values compatible with the type DateTime and the second column with values that are compatible with the types float or Double.

    This function can be called as shown below:

    Paste code macro
    languagecs
    string tagName = @"SE01\TR01\tag1.MED.MW";
    DataTable result = GetHistorianMeasures(tagName);
    if(result != null && result.Rows.Count > 0)
        barAndSplineCustomChart1.ChartControl.ApplyHistorianData(tagName, result);

    Note

    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

    Attention: It is extremely important that the table follows the expected format with two columns, being:

    • First column with values compatible with type DateTime; and

    • Second column with values compatible with types float or Double.

    Tables that do not support this format can have unexpected consequences for the chart.

    This specific application of the example used the Spin toolkit to search for measurements of a certain period (last 10 days). The complete code for this application can be checked below:

    Paste code macro
    languagecs
    titlePage codebehind
    using SPIN.ActionNet.View.Wpf.Charts;
    	  
    public void DisplayOpening()
    {
    }
    
    public void DisplayIsOpen()
    {
    }
    
    public void DisplayClosing()
    {
    }
     
    ////This method is only called on Dialog displays
    public bool DialogOnOK()
    {
    	return true;
    }
    
    public DataTable GetHistorianMeasures(string tagName){
    	DataTable result = null;
    	
    	try{
    		DateTime startDate = DateTime.Now.AddDays(-10);		
    		result = @Script.Class.CustomMeasures.GetMeasures(tagName, startDate, DateTime.Now, 10);
    	}
    	catch(Exception ex){
    		@Info.Trace(ex.Message);
    	}
    	
    	return result;
    }
    
    public void ButGetSampleData_Click(object sender, System.Windows.Input.InputEventArgs e)
    {
    	SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart barAndSplineCustomChart1 = 
    		this.CurrentDisplay.GetControl("barAndSplineCustomChart1") as SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart;
    		
    	if(barAndSplineCustomChart1 != null){
    		string tagName = @"SE01\TR01\tag1.MED.MW";
    		DataTable result = GetHistorianMeasures(tagName);
    		if(result != null && result.Rows.Count > 0)
    			barAndSplineCustomChart1.ChartControl.ApplyHistorianData(tagName, result);		
    	}
    	
    }
    Paste code macro
    languagecs
    titleScript.Class.CustomMeasures script
    using SPIN.ActionNet.Biz.Toolkit.Reports;
    using System.Threading.Tasks;
    
    public DataTable GetMeasures(string tagName, DateTime startDate, DateTime endDate, int interval)
    {
    	List<string> tagNames = new List<string>();
    	tagNames.Add(tagName);
    	
    	DataTable result = Measures.GetReport(tagNames,startDate, endDate, interval);
    	
    	return result;
    }

    Nesta pagina:

    Table of ContentsminLevel1maxLevel3
    
    

    BarAndSplineCustomChart Members

    In the control, users were exposed to some properties and methods for using the chart. In the following tables, you can view the names of properties and methods and their descriptions:

    Properties

    Name

    Description

    TagName

    Name of the tag to which the chart refers. This name will be shown in the chart header

    HistValues

    Observable list of objects of type HistorianValues that contains tag value and timestamp information

    XAxisLabelFormat

    Corresponds to the format of the text you want for the X-axis label. This is the Timestamp axis.

    The default format for this property is "MMM-dd HH:mm".

    XAxisLabelRotationAngle

    Corresponds to the desired angle of rotation for the X-axis label.

    YAxisLabelFormat

    Corresponds to the format of the text you want for the Y-axis label. This is the Values Axis.

    The default format for this property is "N0".

    YAxisLabelRotationAngle

    Corresponds to the desired angle of rotation for the label of the Y axis.

    Methods

    Name

    Description

    ApplyHistorianData(string, DataTable)

    A method that transforms the parameters passed into rows and columns of the chart and applies this information to the chart.

    Parameters

    tagName: refers to the search tag. This parameter is used for the Chart Header.

    histValues: refers to a table whose format consists of the first column with values compatible with the type DateTime and the second column with values that are compatible with the types float or Double

    Scroll ignore
    scroll-viewporttrue
    scroll-pdftrue
    scroll-officetrue
    scroll-chmtrue
    scroll-docbooktrue
    scroll-eclipsehelptrue
    scroll-htmltrue
    scroll-epubtrue

    On this page:

    12false