logo TeeChart .NET教程2018 我也要发布文档

(五)图例设计


【下载TeeChart.Net最新版本】

(一)Legend control——图例控制

图例参数可通过TeeChart编辑器,图表选项卡,图例页面:

teechart?

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

1.1 样式选项卡

Legend Style——图例样式

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

[C#.Net]

tChart1.Legend.LegendStyle = LegendStyles.LastValues; 

[VB.Net]

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——字体系列颜色:

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

1.2 Position Tab

teechart?

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(调整大小图表)”属性,并使您能够在“图表画布”的任何位置以图像为单位定位图例。

1.3 Symbols Tab

width

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

Width Units

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

position

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

Continuous

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

1.4 Format Tab

Color

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

Frame

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

Pattern

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

Round Frame

绕过图例框架的范围。

Transparent

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

Transparency

当Transparent设置为true时,设置Legend的%透明度。

1.5 Text Tab——“文本”选项卡

此页面提供对属性的访问,这些属性可更改图例文本字体的外观,字体的填充属性[填充画笔属性]和阴影。

1.6 Gradient Tab——“渐变”选项卡

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

1.7 Shadow Tab——阴影选项卡

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

1.8 Bevel Tab——斜角选项卡

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

(二)Customising Legends

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

2.1 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

2.2 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 

2.3 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 

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