【TeeChart .NET教程】（五）图例设计

【下载TeeChart.Net最新版本】字体

Legend control——图例控制

图例参数可经过TeeChart编辑器，图表选项卡，图例页面：url

图例参数访问。见传说类的帮助以获取更多信息

样式选项卡 spa

Legend Style——图例样式.net

图例默认样式“自动”将在图表中只有一个系列时将系列点值放入图例中。当图表包含多个系列时，“Automatic（自动）”会将系列名称放入图例中。在编辑器中使用Dropdown Combobox获取默认值之外的值。若是用户更改图例样式以显示值，而且图表中有多个系列，TeeChart Pro将显示第一个系列的值，用户也可使用自定义选项修改显示。
在“Legend（图例）”框中显示每一个系列的最后一个值：code

[C#.Net]orm

tChart1.Legend.LegendStyle = LegendStyles.LastValues;

[VB.Net]blog

TChart1.Legend.LegendStyle = Steema.TeeChart.LegendStyles.LastValues

Vertical Spacing——垂直间距：教程

容许用户修改图例条目之间的间距。

Dividing Lines——分界线：

“Dividing Lines（分隔线）”按钮能够访问“Pen Editor”窗口，能够在其中使“Legend（图例）”条目之间的线条可见，并更改其颜色，样式和宽度。

Visible——可见：

此可见复选框启用/禁用整个图例的显示。

Inverted——倒序：

反转图例会反转图例条目的顺序。

Check Box——复选框：

将图例样式更改成“Series Names（系列名称）”，并在每一个系列旁边显示一个复选框，使其不可见或可见。

Font Series Color——字体系列颜色：

将图例文本的字体颜色更改成系列颜色。

Position Tab

Position——位置:

使用Alignment属性有4个位置，Top，Bottom，Left和Right，右边是默认位置，图例的默认定位始终位于图表以外。

Resize Chart——调整图表大小：

“Resize Chart（调整大小图表）”属性未启用时，将在“图表”框架区域内绘制图例。虽然这对于某些Legend定位要求多是使人满意的，可是经过使用Legend Margin属性能够更好地控制与Chart框架相关的Legend定位。

Margin：

更改Margin属性值将移动Chart框架相对于Legend，反之亦然。所以，将Margin值设为负值会将图表移动到图例上（增长图表矩形区域的大小）。

Position Offset %——位置偏移%：

0％定义为触摸右图表画布边框的水平图例和触摸顶部图标的垂直图例。

Custom

此复选框将禁用“Resize Chart（调整大小图表）”属性，并使您可以在“图表画布”的任何位置以图像为单位定位图例。

Symbols Tab

width
设置Width属性以定义颜色矩形（符号）的宽度。

Width Units
使用WidthUnits属性定义必须如何解释宽度。

position
使用“位置”属性设置颜色矩形的位置。

Continuous
使用连续属性让不一样的图例颜色矩形相互流动。设置为True时，不一样项目的颜色矩形将彼此固定绘制（无垂直间距）。设置为False时，颜色矩形绘制为单独的矩形。

Format Tab

Color
color属性设置Legend画布的颜色。

Frame
设置图例框架属性：可见，样式，颜色和宽度[Pen properties笔属性]。

Pattern
设置图例画布的图案：实体，填充，渐变，图像[Hatch Brush properties填充画笔属性]。

Round Frame
绕过图例框架的角落。

Transparent
使图例画布透明，只显示图例文本和符号。

Transparency
当Transparent设置为true时，设置Legend的％透明度。

Text Tab——“文本”选项卡
此页面提供对属性的访问，这些属性可更改图例文本字体的外观，字体的填充属性[填充画笔属性]和阴影。

Gradient Tab——“渐变”选项卡
使用此页面在图例画布上绘制渐变并更改其方向和颜色。

Shadow Tab——阴影选项卡
设置图例阴影的颜色，大小，图案和透明度。

Bevel Tab——斜角选项卡
设置Legend的内外斜面的颜色，大小和样式。

Customising Legends

Legend事件提供彻底控制定义Legend外观和内容的选项。

OnGetLegendRect事件
图例外部矩形容许更改“图例”框的总体大小和位置。与OnGetLegendPos结合使用以从新定位图表图例和内容。
例如

[C#.Net]

private void tChart1_GetLegendRect(object sender, Steema.TeeChart.TChart.GetLegendRectEventArgs e) 
        { 
            e.Rectangle=new Rectangle(e.Rectangle.Left-100,e.Rectangle.Top,e.Rectangle.Width,e.Rectangle.Height);  
        }

[VB.Net]

Private Sub TChart1_GetLegendRect(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendRectEventArgs) Handles TChart1.GetLegendRect 
        e.Rectangle = New Rectangle(e.Rectangle.Left - 100, e.Rectangle.Top, e.Rectangle.Width, e.Rectangle.Height) 
End Sub

OnGetLegendPos事件
修改图例的内容。如下示例可与上面的代码一块儿使用，将Legend内容移动到新的Legend矩形。

[C#.Net]

private void tChart1_GetLegendPos(object sender, Steema.TeeChart.TChart.GetLegendPosEventArgs e) 
        { 
            e.X = e.X-100; 
            e.XColor = e.XColor-100; 
        }

[VB.Net]

Private Sub TChart1_GetLegendPos(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendPosEventArgs) Handles TChart1.GetLegendPos 
        e.X = e.X - 100 
        e.XColor = e.XColor - 100 
End Sub

OnGetLegendText事件
修改图例内容的文本

[C#.Net]

private void tChart1_GetLegendText(object sender, Steema.TeeChart.TChart.GetLegendTextEventArgs e) 
        { 
            if(e.Index == 3) 
            {e.Text = e.Text + " Index no.:" + e.Index.ToString();} 
        }

[VB.Net]

Private Sub TChart1_GetLegendText(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendTextEventArgs) Handles TChart1.GetLegendText 
        If e.Index = 3 Then 
            e.Text = e.Text + " Index no.:" + e.Index.ToString 
        End If 
End Sub

将图例放置在图表矩形区域内时，图例在系列和轴以前绘制，而且将出如今任何交叉点的任何一个下方。