TeeChart for PHP教程（五）：Legend设计

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

                                                                   点击下载TeeChart for PHP试用版

---

    本教程是TeeChart for PHP教程中Legend设计这一节。本章节的内容主要分为以下几个部分：

• Legend控制

• 样式

• 定位Legend

• 水平图例中的行数

• 彩盒改装

  ---

Legend控制  

样式

Legend样式

    在图表中只有一个系列时，图例默认样式的Automatic将会把将系列点值放入图例中。当图表包含多个系列时，Automatic会将系列名称放入图例中。如果您为了显示值而更改图例样式，并且图表中有多个系列，TeeChart将显示第一个系列的值，您可以使用自定义选项修改显示：

$tChart1->getLegend()->setLegendStyle(LegendStyles::$LASTVALUES);
//Puts the last value of each Series in the Legend box

文本样式

    文本样式可以格式化图例中的系列条目（例如，将值显示为总计的百分比等）。

定位Legend

对准

    可以有4个默认位置被用于对准方法（顶部，底部，左侧和右侧），其中右边是默认位置。图例的默认定位始终位于图表之外。

调整图表大小

    未启用时，调整大小图表方法将在图表框架区域内绘制图例。虽然这对于某些Legend定位要求可能适用的，但是通过使用Legend HorizMargin和VertMargin属性可以更好地控制与Chart框架相关的Legend定位。

HorizMargin和VertMargin

    Horizmargin适用于左右对齐的Legend，VertMargin适用于顶部和底部对齐的图例。更改Horizmargin方法的值将会相对于Legend去移动Chart框架，反之亦然。因此，将Horizmargin值设为负值会将图表移动到图例上（增加图表矩形区域的大小）。但是，这些方法不适用于重新定位图表上的图例，为了实现这一点，最好使用下面概述的方法。

自定义位置

    将Legend CustomPosition方法设置为true，然后将Legend的Top和Left像素坐标设置为自定义位置。

$tChart1->getLegend()->setCustomPosition(true);
$tChart1->getLegend()->setTop(100);
$tChart1->getLegend()->setLeft(100);

水平图例中的行数

    图例水平对齐（顶部或底部）时，可以指定行数：

$ tChart1-> getLegend（） - > setMaxNumRows（3）;

    默认情况下，MaxNumRows为0（零），这意味着Legend将根据需要使用尽可能多的行显示所有值。

彩盒改装（符号）

    使用色宽的方法设置图例中颜色框的宽度。

//move the colour boxes to the right of the value list
$tChart1->getLegend()->getSymbol()->setPosition(LegendSymbolPosition::$RIGHT);
//set the boxes as continuous
$tChart1->getLegend()->getSymbol()->setContinuous(true);
//Make the boxes wider
$tChart1->getLegend()->setColorWidth(40);
//Hide the Pen of the line between the boxes
$tChart1->getLegend()->getDividingLines()->setVisible(false);