TeeChart for PHP教程（一）：构建图表并填充数据系列-控件新闻-慧都网

TeeChart for PHP教程（一）：构建图表并填充数据系列

翻译|使用教程|编辑：况鱼杰|2019-07-23 14:16:44.590|阅读 424 次

概述：本教程介绍TeeChart for PHP的设计方面以及构建图表的入门指南。

相关链接：

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

点击下载TeeChart for PHP试用版

  本教程是TeeChart for PHP教程中构建图表并填充数据系列这一节，内容分为以下几个部分：

介绍
建立图表
在表格上包括TeeChart
填充新数据系列
选择系列类型以满足您的需求

介绍

您可以定义图表的外观，标题，图例特征和3D效果，而其中无需包含数据系列，这使您可以自由地在运行时添加和删除不同的数据系列类型，而无需重新定义整个图表的外观。

所有东西都汇集在一起制作最终的Chart，Chart轴是Chart和Series之间的接口。Series具有数据，其值将影响Chart轴的标签特征，在添加数据系列之前，可以为图表定义轴外观，颜色，网格频率和标签字体。

TeeChart将对大多数值进行最佳估计，以最大限度地减少您手动定义Chart和Series方法的需要。本教程中的步骤强调了从头开始构建图表是多么容易，并将通过后面的教程继续向您介绍，以便在运行时修改和进一步增强图表的外观和功能。

建立图表

将TeeChart包含在PHP网页

要在PHP网页上包含Tchart组件很容易。您只需要在服务器上添加TeeChart for PHP库的路径作为include：

<?php
include "../sources/libTeeChart.php";
?>

这将允许您与TeeChart for PHP类进行交互。 TChart并使用以下代码渲染它：

 <?php
$tchart = new TChart(500,300);    // specifying its size (width , height)
$tchart->render("tchart.png");
?>

现在，需要一些html行才能在同一页面上显示图像：

<body>
<img alt="" src="tchart.png" style="border: 0px solid gray;"/>
</body>

将TeeChart包含在Delphi for PHP表单中

如果要在Delphi for PHP IDE下使用TeeChart for PHP库，必须执行以下步骤：

将\ teechart文件夹复制到Delphi for PHP安装的\ vcl文件夹中，创建以下文件夹：
\Delphi for PHP\vcl\teechart
\Delphi for PHP\vcl\teechart\sources
\Delphi for PHP\vcl\teechart\demos\*,*
\Delphi for PHP\vcl\teechart\docs\*,*
将\ teechart \ sources \ tchart.inc.php和\ teechart \ sources \ tchart.ide.inc.php文件复制到Delphi for PHP的\ vcl文件夹中。
打开Delphi for PHP IDE，转到Component - > Packages菜单选项，单击Add并查找\ teechart \ sources \ TeeChart.package.php文件。这会将TeeChart for PHP Components项添加到已安装的软件包列表中，现在单击OK。
如果你创建一个新的Delphi for PHP项目并转到设计页面，工具面板上会出现一个新的TeeChart选项卡。你会在那里找到TChartOBj组件。您应该能够选择它并将其放在表单上，就像任何其他组件一样。

选择TChartObj图标，单击并拖出以在PHP表单上调整TChartObj的大小。您将看到TChartObj作为一个面板，其中包含一些基本的图表功能。

填充新数据系列

对于编程的数据输入，您需要编写一些代码，本节将向您展示使用编码输入构建图表所需的步骤。在运行时，除非您手动填充数据，否则系列将清空数据。这里有一个填充它们的代码示例：

$tChart1 = new TChart(500,300); $bar = new Bar($tChart1->getChart()); $tChart1->getAxes()->getBottom()->setIncrement(1); $bar->addYTextColor(400, "pears", Color::GREEN()); $bar->addYTextColor(500, "apples", Color::RED()); $bar->addYTextColor(400, "bananas", Color::YELLOW()); $bar->addYTextColor(200, "oranges", Color::ORANGE());

运行项目，新图表将显示。

在这种情况下，我们使用了addXYTextColor（XValue，YValue，Text，Color），但有更多可用的：

$bar->addXY(XValue,YValue) $bar->addXYText(XValue,YValue,Text) $bar->addXYColor(XValue,YValue,Color) $bar->addYText(YValue,Text) $bar->addYTextColor(YValue,Text,Color) $bar->addYColor(Value,Color) $bar->addText(Text) $bar->add() $bar->addNull() $bar->addNullXY(XValue,YValue)

因此，add（）方法假定Label轴上的值间隔相等（在本例中为X轴）。如果您的数据包含2个变量，则可以使用AddXY方法。运行项目并使用以下代码添加点：

require_once "../sources/TChart.php" $tChart1 = new TChart(500,300);

这里我们使用addYTextColor来允许我们指定Text和Color，但是如果不需要这些，您可以直接使用add（YValue）方法。

选择系列类型以满足您的数据需求

最后一个编码示例生成了新的X和Y值，点之间的X轴距离可能不是恒定的，这取决于所使用的值，在某些情况下可能导致条形图重叠。不是所有应用都可以如此使用，您可以使用ChangeSeriesType（）方法更改特定Series的类型。新的Series类型必须以图形方式表示具有相同数量变量的数据。如果您的数据包含新类型的不同数量的变量，则会出现错误。下表显示了TeeChart系列类型的组成：

系列类型	变量数量	数据源属性
Standard types
Line	2	XValues, YValues, XLabel
Horizontal Line	2	XValues, YValues, XLabel
Fast Line	2	XValues, YValues, XLabel
Bar	2	XValues, YValues (called Bar), XLabel
HorizBar	2	XValues, YValues (called Bar), XLabel
Area	2	XValues, YValues, XLabel
HorizArea	2	XValues, YValues, XLabel
Points	2	XValues, YValues, XLabel
Pie	1	PieValues, XLabel
Arrow	4	StartXValues, StartYValues, XLabel, EndXValues, EndYValues
Bubble	3	Xvalues, YValues, XLabel, RadiusValues
Gantt	3	StartValues, EndValues, AY (Y axis level), AXLabel (Label optionally shown on Y-axis or as mark)
Shape	4	X0 (Top), Y0 (Bottom), X1 (Left), Y1 (Right)
Subset of Extended Types
Bezier	2	XValues, YValues, XLabel
Candle	5	OpenValues, CloseValues, HighValues, LowValues, DateValues
Polar	2	XValues, YValues, Labels (Polar has Angle and Radius)
Volume	2	XValues, YValues (VolumeValues), XLabel