在上一篇文章中,讲到使用函数中功能类型的功能特点、添加功能和定义数据源,在本文中将介绍其余三种,功能期、周期样式和派生自定义功能。

1 功能期

Period是使用函数的重要方法,因为Period定义了循环应用Function的点的范围。

例:我们有6个数据点(例如Bar系列的条形图),其值为:3,8,6,2,9和12。定义一个具有周期0的函数系列(默认),绘制的平均值为:6.667,将Period设置为2,我们得到3个平均值作为函数的输出:5.5,4和10.5。这些值将在其周期范围内集中绘制,即。输入系列的第1和第2栏之间的第1个值,第3和第4栏之间的第2个值等。您可以通过在图表编辑器中选择函数来定义Period,也可以使用FunctionType在运行时修改Period。例如:系列2是功能系列:


line1.getFunction().setPeriod(2);


Java式样书 java样式如何调整教程_Teechart

2 周期样式

期间可以定义为范围。这在使用DateTime系列时非常有用,我们希望将函数的“Period”表示为TimeStep。属性“PeriodStyle”控制如何表达“Period”?例如,您现在可以使用日期时间源系列上的常规“Average”功能绘制“monthly average of sales”功能,并将功能期间设置为“one month”:

private void Load() {
        //Add in a BarSeries and Average Function at design-time. 
        java.util.Random rnd = new java.util.Random();   
        tChart1.getAspect().setView3D(false);   

        DateTime today = DateTime.getToday();
    
        bar1.getMarks().setVisible(false); 
        bar1.getXValues().setDateTime(true); 
        tChart1.getAxes().getBottom().getLabels().setAngle(90); 
    
        for(int i = 0; i < 60; ++i)  
            today = today.addDays(5); 
            bar1.add(today, rnd.nextInt(100),"",Color.red); 
    
    
        average1.setPeriodAlign(com.steema.teechart.functions.PeriodAligns.FIRST); 
        average1.setPeriodStyle(com.steema.teechart.functions.PeriodStyles.RANGE); 
        average1.setPeriod(30); 
        line1.setDataSource(bar1); 
        line1.checkDataSource();
}


这将产生几个点,每个点显示BarSeries中每个月数据的“average”。在计算日期时间段的函数时,必须按源日期对源系列中的点进行排序。该范围也可用于非日期时间序列:

for(int i = 0; i < 60; ++i)  
             bar1.add(new Double(i), rnd.nextInt(100),"",Color.red); 
        
        average1.setPeriodAlign(com.steema.teechart.functions.PeriodAligns.FIRST); 
        average1.setPeriodStyle(com.steema.teechart.functions.PeriodStyles.RANGE); 
        average1.setPeriod(6);


这将计算每个“6”区间内每组点的平均值。(X > = 6,X < 6 的点将用于计算第一个平均值,X> = 6的点,X < 12将用于计算第二个平均值,依此类推......)。 请注意,这与计算每6个点的平均值不同。使用“Period Alignment”属性可以对齐“Series”范围内的功能点。以下将绘制每月结束时的功能点:

average1.setPeriodAlign(com.steema.teechart.functions.PeriodAligns.FIRST); 
	average1.setPeriodStyle(com.steema.teechart.functions.PeriodStyles.RANGE); 
	average1.setPeriod(com.steema.teechart.DateTime.getDaysInMonth(year,month));
    Period = Month.TotalDays and PeriodAligns.First


Java式样书 java样式如何调整教程_教程_02

Period = Month.TotalDays and PeriodAligns.Last

在这种情况下,“average”是在月初绘制的。

Java式样书 java样式如何调整教程_Java式样书_03

3 派生自定义功能

创建一个新的Function组件只是创建一个派生自Function类的新组件(它也可以从现有函数派生)。 在TTeeFunction中有两个重要的虚拟方法可以被覆盖以创建一个新的Function类型。

1. Function.Calculate: public virtual double Calculate(Series Source,int First,int Last)
2. Function.CalculateMany: public virtual double CalculateMany(ArrayList SourceSeries, int ValueIndex)

如果只有一个系列是数据源,则Calculate方法用于计算函数结果。如果多个系列可以是数据源,则CalculateMany用于计算函数结果。示例:创建新的SquareSum功能。需要一个SquareSum函数来返回“sum of squares平方和”。此函数只能有一个数据源或多个数据源,因此我们将覆盖Calculate和CalculateMany方法。

public class SquareSum extends Function {

    public SquareSum() {
     super();
    } 


    public SquareSum(com.steema.teechart.Chart c) {
	super(c);
    }

    public double calculate(Series sourceSeries,
                            int firstIndex,
                            int lastIndex) {
        ValueList v = valueList(sourceSeries);
        if (firstIndex == -1) {
            return v.getTotal();
        } else {
            double result = 0;
            for (int t = firstIndex; t <= lastIndex; t++) {
                result+=Math.sqrt(v.getValue(t));
            }
            return result;
        }
    }

    public double calculateMany(ArrayList sourceSeriesList,
                                int valueIndex) {
        ValueList v;
        double result = 0;

        for (int t = 0; t < sourceSeriesList.size(); t++) {
            v = valueList((Series) sourceSeriesList.get(t));
            if (v.count > valueIndex) {
                result+=Math.sqrt(v.getValue(valueIndex));
            }
        }
        return result;
    }

FirstIndex和EndIndex变量用于“loop”所有SourceSeries点以计算平方和。“ValueList”方法用于提取必需的Steema.TeeChart.ValueList,以使该类适用于像HorizBarSeries这样的Series类型,其中“XValues”保存点值而不是“YValues”。当Series 只有一个 Series作为DataSource 时,使用“Calculate”方法。当Series有多个Series作为数据源时,将调用“CalculateMany”方法。对于源系列中的每个点,“CalculateMany”将被调用一次,从零开始,以所有数据源的最小点数结束。 理解Calculate和CalculateMany之间的区别非常重要。当只有一个数据源并且只调用一次时调用“Calculate”。当有多个Series作为数据源时,会多次调用“CalculateMany”(每个点一个)。