图例设计
加入官方社群740060302,欢迎相互交流
图例参数可通过TeeChart编辑器、图表选项卡、图例页面访问:
有关图例参数的更多信息,请参阅图例类帮助
Style Tab
Legend Style
当图表中只有一个系列时,图例默认样式“Automatic”将在图例中显示系列点值。当图表包含多个系列时,“Automatic”将在图例中显示系列名称。在编辑器中,使用下拉组合框获取默认值以外的值。如果您更改图例样式以显示值,并且图表中有多个系列,则TeeChart Pro将显示第一个系列的值。您可以使用自定义选项修改显示。参见自定义图例
将每个系列的最后一个值放入“Legend”框中:
[C#] tChart1.Legend.LegendStyle = LegendStyles.LastValues; [VB.Net] TChart1.Legend.LegendStyle = Steema.TeeChart.LegendStyles.LastValues
Text Style
有关可能的Legend文本样式列表,请参阅TextStyle属性。
Vertical Spacing
允许您修改图例项之间的间距。
Dividing Lines
“Dividing Lines”按钮提供了“Pen Editor”窗口的访问权限,在该窗口中,您可以使图例条目之间的线条可见,并更改其颜色,样式和宽度。
Visible
这个Visible 复选框启用/禁用整个图例的显示。
Inverted
倒排图例将使图例条目的顺序颠倒。
Check Boxes
将图例样式更改为“Series Names”,并在每个系列旁边显示一个复选框,允许它不可见或可见。
Font Series Color
将“图例”文本的字体颜色更改为系列颜色。
Position Tab
Position
使用Alignment属性可以选择4个位置:Top, Bottom, Left和Right。右是默认位置。图例的默认位置将始终位于图表之外。有关定位图例的更多信息,请参阅关于自定义图例一节。
Resize Chart
未启用“调整图表大小”属性时,将在“图表框架”区域内绘制图例。虽然这可能满足某些图例定位要求,但通过使用图例边距属性可以更好地控制图例定位与图表框架的关系。
Margin
更改页边距属性值将使图表框架相对图例移动,反之亦然。因此,设置边距值为负值将使图表移动到图例上方(增加图表矩形区域的大小)。但是,这些属性不是用来在图表上重新定位图例的,最好使用自定义图例中概述的技术。
Position Offset %
0%被定义为触及图表画布右侧边框的水平图例和触及顶部边框的垂直图例。图例相对于这些位置被偏移。
Custom
此复选框将禁用“Resize Chart ”属性,并使您能够以像素为单位在图表画布上的任何位置定位图例。
Symbols Tab
Width
设置Width属性来定义颜色矩形(符号)的宽度。
Width Units
使用WidthUnits属性来定义如何解释宽度。
Position
使用位置属性设置颜色矩形的位置。
Continuous
使用连续属性让不同的图例颜色矩形相互流动。当设置为True时,不同项目的颜色矩形彼此固定绘制(没有垂直间距)。当设置为False时,颜色矩形被绘制为单独的矩形。
Format Tab
Color
color属性设置Legend画布的颜色。
Frame
设置图例框架属性: Visible, Style, Color,Width [Pen properties].
Pattern
设置图例画布的模式: Solid, Hatch, Gradient, Image [Hatch Brush properties].
Round Frame
图例框架的圆角。
Transparent
使图例画布透明,仅显示图例文本和符号。
Transparency
当Transparent设置为true时,设置图例的%透明度。
Text Tab
这个页面提供了改变图例文本字体外观的属性,字体的填充属性[Hatch Brush属性]和阴影。
Gradient Tab
使用此页面在图例画布上绘制渐变,并更改其方向和颜色。
Shadow Tab
设置图例阴影的颜色、大小、模式和透明度。
Bevel Tab
设置图例的内斜面和外斜面的颜色、大小和样式。
Customising Legends
图例事件提供了完全控制定义图例外观和内容的选项。
OnGetLegendRect event
“图例”外矩形允许更改“图例”框的总体大小和位置。与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 event
修改图例的内容。下面的示例可以与上面的代码一起使用,将Legend内容移动到新的Legend矩形中。
[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 event
修改图例内容的文本。
[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
当将图例放置在“图表”矩形区域中时,请记住图例绘制在“系列”和“轴”之前,并且在任何交点处都会显示在它们的下方。