【TeeChart for Java教程】（七）上：使用函数——功能特点、添加功能和定义数据源

（一）功能类型

1.1 功能特点

TeeChart Pro功能是一个系列，几乎可以是任何系列类型，应用代数函数，数据源是另一个图表系列。所有函数都派生自TeeFunction Component并继承TeeFunction的Period 方法。TeeChart Pro包含以下预定义功能列表，有关所有功能类型的完整列表，请参阅TeeChart Editor Gallery和Helpfile：

功能类型	投入数量	描述
Add	无限	绘制输入总和
Average	无限	平均函数将计算每组Period点的平均值
Copy	1	输入系列的直接副本
Divide	无限	分割函数绘制输入按包含的降序划分
High	无限	高功能绘制高输入点
Low	无限	低功能绘制低输入点
Multiply	无限	乘法函数绘制输入值的乘积
Subtract	无限	绘图的输入值按包含的降序减去
Mode	1	mode函数返回重复多次的源序列值
Median	1	计算源系列值的中值
Count	1	在Y位置绘制水平线，该水平线由基础系列中的点数定义。
Pro版本的子集（仅函数）
Bollinger	1	布林线函数使用简单或指数移动平均线来构建布林线交易区间
Curve Fitting	1	使用TypeFitting公式通过数据输入绘制拟合多项式
Exponential Average	1	基于权重的指数平均值
Exponential Moving Average	1	基于权重的指数移动平均线
Exponential Trend	1	通过输入系列中的点绘制最佳指数趋势线
MACD	1	移动平均收敛分歧
Momentum	1	每个Y值是当前点的Y值减去最后一个Period点的Y值
Momentum Division	1	每个Y值是当前点的Y值除以最后一个Period点的YValue，以百分比表示
Moving Average	1	移动平均线功能将计算每组周期点的简单或加权平均值
Root Mean Square	无限	均方根函数绘制输入的RMS值
Relative Strength Index	1	RSI函数根据财务数据计算百分比值。根据TRSISyle类型，将使用不同的公式来计算RSI值
Standard Deviation	1	映射每组Period点的标准偏差（或完全标准差）
Stochastic	1
Trend	1	通过输入系列点绘制最佳趋势线

多种函数类型仅支持一个输入系列。但是，可以链接链接函数，例如，将图表中多个系列的平均值创建为平均函数系列，然后使用平均函数作为趋势函数的输入来标识平均值的趋势。

1.2 添加功能

使用图表编辑器，在“First Chart”页面上，选择“Add”按钮，就像将新系列添加到图表一样。在TeeChart Gallery中，选择Functions选项卡以选择所需的功能。每个功能都显示为一个系列，您可以稍后通过选择第一个图表页面上的更改按钮来更改与该功能关联的系列类型。之后，在函数系列的“Datasource”页面上可以轻松更改函数定义。在这里，同样容易，您可以将已添加到Chart的正常Series的定义更改为Function的定义（Function实际上是数据源的定义，而不是Series Type的定义）。

下图显示了编辑函数时的“Datasource”页面，数据源页面底部的左侧列表框显示了可用于输入的图表中的其他系列（此处为“Series1”）。

teechart_for_java

假设我们从一个完全空的Chart开始，这里是代码中用于构建简单的Series-Function相关Chart的步骤。

private void Load() {

//Add a data Series 
Line line1 = new Line(tChart1.getChart());

//Populate it with data (here random) 
line1.fillSampleValues(10); 

//Add a series to be used for an Average Function 
Line line2 = new Line(tChart1.getChart()); 

//Define the Function Type for the new Series 
com.steema.teechart.functions.Average average1 = new com.steema.teechart.functions.Average(); 
line2.setFunction(average1); 

//Define the Datasource for the new Function Series 
line2.setDataSource(line1); 

//*Note - When populating your input Series manually you will need to 
//use the Checkdatasource method 
//- See the section entitled 'Defining a Datasource' 
//Change the Period of the Function so that it groups averages 
//every 2 Points 
line2.getFunction().setPeriod(2); 
line2.checkDataSource();
}

添加另一个函数来介绍有关前一个函数的信息

public void button1_actionPerformed(ActionEvent e) {

//Let's change to 2D for visibility 
tChart1.getAspect().setView3D(false); 
//Add another Series to be used for a 2nd Function 
Line line3 = new Line(tChart1.getChart()); 
//Define the Function Type for the new Series 
com.steema.teechart.functions.High high1 = new com.steema.teechart.functions.High(); 
line3.setFunction(high1); 
//Define the Datasource for the new Function Series 
//Use the existing Function (Series2) as input 
line3.setDataSource(tChart1.getSeries(1)); 
//Leave the Period at default 0 (No Period set) to draw 
//A line at Highest of all points of the Average Function

1.3 定义数据源

Series使用Datasource定义Function的输入或定义Series TDataset数据源。使用图表编辑器，在添加函数后，函数系列的“Datasource”页面将显示包含在函数定义中的可用系列列表。在这里，您可以更改要应用于系列的函数类型，并从左侧列表框“Available”中选择系列，并将它们添加到右侧列表框“Selected”。按代码的数据源使用Series.Datasource属性。例，假设我们在设计时通过TeeChart编辑器添加了2个数据系列。我们添加了一个由2系列的平均值组成的函数：

private void Load() {
 tChart1.getAspect().setView3D(false); 
  bar1.fillSampleValues(10); 
  bar2.fillSampleValues(10); 
 }

public void button1_actionPerformed(ActionEvent e) {
  com.steema.teechart.styles.Line line1 = new 
  com.steema.teechart.styles.Line(tChart1.getChart()); 
  com.steema.teechart.functions.Average average3 = new 
  com.steema.teechart.functions.Average(); 
  Object[] tmpDataSource ={bar1,bar1};
  line1.setFunction(tmpDataSource); 
  line1.setDataSource(bar1); 

  line1.getMarks().setVisible(true);
}

为2系列添加点数：

public void button1_actionPerformed(ActionEvent e) {

  java.util.Random rnd = new java.util.Random();
    for(int i = 0; i < 10; ++i) 
     bar1.add(rnd.nextInt(500)); 
     bar2.add(rnd.nextInt(500)); 
   }
}

该功能不会显示。您需要使用checkDataSource方法读入Function的值。

tChart1.getSeries(2).checkDataSource();

可以在运行时更改函数定义，只需通过重新定义Series.DataSource方法将新函数分配给Series：

public void button3_actionPerformed(ActionEvent e) {
	com.steema.teechart.functions.Cumulative cumulative1 = new com.steema.teechart.functions.Cumulative(); 
	tChart1.getSeries(2).setFunction(cumulative1);