半岛权威十大直营(官方)网站

    TeeChart for PHP包含100%的PHP源代码。它支持PHP5及更高的版本。它可作为一个调色板组件整合到针对PHP的Delphi编程环境中，从而让其他人在运行时以创建组件的方式来引用。第一个版本提供17种图表类型（2D和3D的多种组合），11个数学函数和一些图表工具组件以扩展功能。

点击下载TeeChart for PHP试用版

    本教程是TeeChart for PHP教程中与系列一起工作这一节。本章节的内容主要分为以下几个部分：

1. 系列类型

2. 在图表上可混合系列类型

3. 系列价值表

4. 系列事件

    上一节我们介绍到了与系列一起工作（上）的系列类型，这一章节我们会接着介绍这一部分内容的下篇，内容包括在图表上可混合系列类型，系列价值表和系列事件。

在图表上可混合系列类型

    TeeChart Pro提供了一个空的Chart Canvas作为数据系列的背景，这意味着没有预定义图表类型，但是您可以将所需的图表类型定义为要显示的系列类型的混合。由于某些系列类型的特殊性质，在图表上混合使用一些系列类型是不切实际的。当您到达添加新系列这一步骤时，TeeChart会通过在图表库中显示不适合的系列类型标识来帮助您。您可以在一个图表中放置的系列数量是没有实际限制。

添加新系列

    使用图表编辑器（参见教程1）或按代码添加系列。

$bar1 = new Bar($tChart1->getChart());
$bar1->fillSampleValues(10);

选择系列的轴

    添加到图表中的系列将自动将左轴和下轴作为参考轴。您可以更改参考轴，有4个轴可用：顶部，左侧，底部和右侧。通过代码，更改轴将如下所示：

$bar1->setHorizontalAxis(HorizontalAxis::$TOP);
$bar1->setVerticalAxis(VerticalAxis::$RIGHT);

    每个轴都可以关联1个以上的系列。TeeChart将决定适合与轴匹配系列的最佳比例，但您可以自己更改轴的Scales（参见轴控制的Scales部分）。可以添加附加轴，它们将复制与前4个轴相对应的刻度（参见轴控制的附加轴部分）。

连接系列

您能够把一个系列当做另一个系列的数据源，通过以下代码完成：

$bar1 = new Bar($tChart1->getChart());
$bar1->fillSampleValues();
$line1 = new Line($tChart1->getChart());
$average1 = new Average();
$line1->setFunction($average1);
$line1->setDataSource($bar1);
$line1->checkDataSource();

    关于如何去使用Teechart函数的更多信息可以参加我们的下一章节内容—TeeChart for PHP教程（七）：函数的使用。

更改系列订单

  ;  更改系列订单非常简单。系列订单将决定系列在图表中相对于其他系列的相对显示位置。使用SeriesList属性或ExchangeSeries方法能够达到这个效果。

$tChart1->exchangeSeries(0,1);  //Change Series(0) with Series(1) in the index order

注意：交换Series后，系列的索引将被更改，因此，如果代码重新运行，上面的代码行将永久地交换2系列的0和1，0变为1，1变为0。

将系列设置为活动=假，系列将会从图表中隐藏，但保持其数据内容不变。

系列价值表

    TeeChart系列通过TChartValueList组件将其值存储在可访问和可修改的Valuelist中。

使用值的示例

  ;  此代码需要用户的鼠标单击修改BarSeries Bar的值。

upDatePoint($valueIndex,$tChart1->getAxes()->getLeft()->calcPosPoint($e->Y));

    调用UpdatePoint Sub例程来修改Bar的值：

private function upDatePoint($bar, $Y)
{ 
   if($bar < $tChart1->getSeries(0)->getCount())
   {
      $tChart1->getSeries(0)->getYValues()->setValue($bar,Y);
   }
}

系列事件

OnGetAxisLabel

    在我们想要更改或向一些或者所有轴标签添加额外文本的情况下，必须使用OnGetAxisLabel事件，它允许获取将要显示的LabelText并在需要时修改它。

    在这里我们可以看到一个使用示例：

<?php
//Includes
include "../../../sources/TChart.php";

function handleLoad($sender, $args)
{
// print 'object '.get_class($sender).' loaded with '.count($args).' args!<br />';
$sender->getHeader()->setText("OnLoad Event");
}

function handleUnLoad($sender, $args)
{
?><br><br><?php
print 'object '.get_class($sender).' unloaded with '.count($args).' args!<br />';
?></br><?php
}

// Args contains axis, index order to be displayed, labelText
function handleGetAxisLabel($sender, $args)
{
// If it's going to display left axis labels 
if ($args[0] === $sender->getAxes()->getLeft()) 
{ 
// if the left axis label value is bigger than 50 add extra character
if ((int)$args[2] > 50) {
$args[0]->getLabels()->labelText = $args[2].'-e';
}
} 
else
{
if ($args[0] === $sender->getAxes()->getBottom()) 
{ 
if ((int)$args[2] < 4) {
// if value is less than 5 changes its labeltext
$args[0]->getLabels()->labelText = $args[2].'-u';
} 
}
} 
}

$handlers = new EventHandlerCollection();
$handlers->add(new EventHandler(new ChartEvent('OnLoad'),'handleLoad'));
$handlers->add(new EventHandler(new ChartEvent('OnUnload'),'handleUnload'));
$handlers->add(new EventHandler(new ChartEvent('OnGetAxisLabel'),'handleGetAxisLabel'));

$chart = new TChart(500,300, $handlers);

$chart->getAspect()->setView3D(false);

$points = new Points($chart->getChart());
$chart->addSeries($points);

$points->fillSampleValues();
$points->getPointer()->setHorizSize(10);
$points->getPointer()->setVertSize(5);
$points->setColorEach(true);

//$chart->getLegend()->getSymbol()->setWidth(10);

$chart->getLegend()->getSymbol()->setSquared(false);


$chart->render('chart.png');
$rand=rand(); 

print '<font face="Verdana" size="2">This Demo shows how to use the OnLoad, OnUnload and OnGetAxisLabel Events<p>';
print '<img src="chart.png?rand='.$rand.'">'; 
?>

    到这里TeeChart for PHP教程（六）就介绍完成了，在文中我也有提到，下一节我们将会介绍TeeChart for PHP教程（七）：函数的使用。如果您有任何的建议或者疑惑都可以在评论区留言哦！

  TeeChart for PHP已加入在线订购，现在抢购即可享受优惠！

    关注慧聚IT微信公众号☟☟☟，了解产品的最新动态及最新资讯。