TeeChart Pro .NET使用教程（2022）：如何进行图例设计

TeeChart Pro 将自动为您定义所有 Axis 标签，并提供足够的灵活性来定制您可能有的任何特定要求。 TeeChart Pro 提供真正的多轴。 这些在设计或运行时可用，并为 Axis 定义提供了无数的可能性和灵活性。

图例控制

图例控制图例参数可通过 TeeChart 编辑器、图表选项卡、图例页面访问：

样式选项

图例默认样式“自动”将在图表中只有一个系列时将系列点值放入图例中。 当图表包含多个系列时，“自动”会将系列名称放入图例中。 在编辑器中，使用下拉组合框获取默认值以外的值。 如果您更改图例样式以显示值并且图表中有多个系列，TeeChart Pro 将显示第一个系列的值。 您可以使用自定义选项修改显示。

将每个系列的最后一个值放入图例框中：

[C#] 
tChart1.Legend.LegendStyle = LegendStyles.LastValues; 
 
[VB.Net] 
TChart1.Legend.LegendStyle = Steema.TeeChart.LegendStyles.LastValues 

允许您修改图例条目之间的间距。

Dividing Lines 按钮可以访问钢笔编辑器窗口，您可以在其中使图例条目之间的线条可见并更改其颜色、样式和宽度。

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

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

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

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

• 垂直间距
• 分割线
• 可见的
• 倒
• 复选框
• 字体系列颜色

位置选项

使用 Alignment 属性可以使用 4 个位置，Top、Bottom、Left 和 Right。右是默认位置。图例的默认位置总是在图表之外。

Resize Chart 属性在未启用时将在 Chart 框架区域内绘制图例。虽然这对于某些图例定位要求可能是令人满意的，但可以通过使用图例边距属性来更好地控制图例相对于图表框架的定位。

更改 Margin 属性值将相对于图例移动图表框架，反之亦然。因此，将边距值设为负会将图表移动到图例上方（增加图表矩形区域的大小）。但是，这些属性不适用于在图表上重新定位图例，最好使用自定义图例中概述的技术。

0% 定义为水平图例触及右侧图表画布边框和垂直图例触及顶部。图例相对于这些位置偏移。

此复选框将禁用调整图表大小属性，并使您能够在图表画布上以像素为单位定位图例。

• 位置
• 调整图表大小
• Margin
• 位置偏移
• Custom

符号选项

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

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

使用 Position 属性设置颜色矩形的位置。

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

• 宽度
• 宽度单位
• 位置
• 连续

格式选项

color 属性设置图例画布的颜色。

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

设置图例画布的图案：实心、阴影、渐变、图像 [阴影画笔属性]。

使图例框架的角变圆。

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

当透明设置为 true 时，设置图例的 % 透明度。

• 颜色
• 框架
• 图案
• 圆形框架
• 透明
• 透明度

文本选项

此页面可以访问更改图例文本字体外观的属性、字体的填充属性 [Hatch Brush 属性] 和阴影。

渐变选项

使用此页面在图例画布上绘制渐变并更改其方向和颜色。

影子标签

设置图例阴影的颜色、大小、图案和透明度。

斜角标签

设置 Legend 内部和外部斜面的颜色、大小和样式。

自定义图例

图例事件提供了完全控制定义图例外观和内容的选项。

OnGetLegendRect 事件

图例外部矩形允许更改图例框的整体大小和位置。 与 OnGetLegendPos 结合使用可重新定位图表图例和内容。

[C#] 
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 事件

修改图例的内容。 下面的示例可以与上面的代码一起使用，将图例内容移动到新的图例矩形。

[C#] 
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#] 
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 

将图例放置在图表矩形区域内时，请记住图例在系列和轴之前绘制，并且将出现在任何交叉点的任何一个下方。