图表显示属性
加入官方社群740060302,欢迎相互交流
图表显示功能是指那些影响图表整体外观的功能。它们包括定义图表背景颜色、标题及其位置、边距、边框和斜面、背景图像、框架和Legend、Panel颜色和宽度、Walls、3D等的属性和方法。
几乎所有这些属性都可以在设计或运行时通过TeeChart编辑器获得,您可以在运行时以编程方式修改这些属性。整体图表外观属性分为以下几类:
- General
- Axis
- Titles
- Legend
- Panel
- Paging
- Walls
- 3D
如果您打开图表编辑器并浏览图表页面,您将发现这些分组。其他属性会影响图表的“外观”。这些包括系列颜色和标记特征,单个轴和网格显示属性和标签。这些将在以后的教程中专门讨论这些特性的专业作用。
开始使用图表显示属性
将新图表添加到表单中,您将看到它以3D形式显示,具有灰色面板背景,2面墙(底部和左侧),框架(定义图表可绘图区域的框架)和默认图表标题标题“TeeChart”。
右键单击图表并选择“编辑…”,以进入TeeChart编辑器。第一页是系列页面,它是空的,我们对本教程不感兴趣。选择第三个图表选项卡“常规”以访问常规图表属性页。
General图表属性
General选项包括以下3个部分:
- Zoom
- Scroll
- Cursor
Zoom和Scroll将在后面的教程中涉及。
Axis属性
Axes的控制是一个非常复杂的专业领域,在后面的教程中会更深入地讨论。在这里,我们将介绍轴和框架显示的基础知识。
第二个Chart页面包含用于定义轴和框架特征的属性。
图表中有6个主要的Axis。Left, Right, Top, Bottom and Depth Visible。表框架显示为图表可绘图区域的环绕,没有相应的数据特征(参见后壁)。默认情况下,Depth初始化为不可见。从将序列添加到图表并与这些轴相关联的那一刻起,所有其他轴都是可见的(默认为左侧和底部)。自定义轴可以通过使用对话框上的+和-键来添加/删除。要使自定义轴(与任何其他轴一样)可见,必须将系列与轴相关联。有关自定义轴的更多信息,请参阅轴教程。
能够显示axes和 frame的关键属性是:
Visible
此复选框启用或禁用所有轴的显示。如果后墙框架可见,那么当轴被隐藏时,图表环绕仍然可见。结果将出现一个更大的图表,因为没有为轴标签保留区域。每个轴的可见属性(Scales选项卡)覆盖每个轴的可见特性。如果您在列表中选择深度轴,那么您将注意到深度轴缩放。可见默认为“not visible”。
[C#.Net] tChart1.Axes.Left.Visible = true; [VB.Net] TChart1.Axes.Left.Visible = True
Axis: Left, Right, Top, Bottom and Depth Visible
选择您希望在列表框中显示或隐藏的axis,并切换Scales选项卡上的Visible复选框,以控制该特定轴的显示。
[C#.Net] tChart1.Axes.Left.Visible = true; [VB.Net] TChart1.Axes.Left.Visible = True
Titles属性
图表编辑器的标题页控制图表标题、页眉和页脚的特征。
Text
使用下拉组合框选择Title (Header), SubTitle, Foot or SubFoot。在“文本框”中输入所需的文本。你可以输入多行标题。
运行:
Header类的Text属性是一个标准的 .Net String类,可以这样修改,例如:
[C#.Net] tChart1.Header.Text = "My Header Text"; [VB.Net] TChart1.Header.Text = "My Header Text"
Style Alignment
Alignment是指页眉(或页脚)相对于图表区域的对齐,而不是整个图表面板的对齐。图表区域是图表加上轴标签和图例的可绘图区域。
运行:
[C#.Net] tChart1.Header.Alignment = StringAlignment.Far; [VB.Net] TChart1.Header.Alignment = StringAlignment.Far
Position
使用“Position”覆盖“Title”或“Footer”的默认位置,并设置一个自定义位置(相对于图表顶部左侧的像素)。
[C#.Net] tChart1.Header.CustomPosition = true; tChart1.Header.Top = tChart1.Header.Top + 10; [VB.Net] TChart1.Header.CustomPosition = True TChart1.Header.Top = TChart1.Header.Top + 10
Format
Format包含标题框的设置,例如:框的颜色,框周围框架的钢笔属性,框的笔刷属性[Pattern]等。
例如Pattern。Pattern指的是标题框或页脚框的背景图案[solid, hatch, gradient or image]。
默认值是Transparent,这意味着在选中Transparent复选框之前,标题框是不可见的。
运行:
[C#.Net] tChart1.Header.Transparent = false; tChart1.Header.Brush.Style = System.Drawing.Drawing2D.HatchStyle.Cross; [VB.Net] TChart1.Header.Transparent = False TChart1.Header.Brush.Style = System.Drawing.Drawing2D.HatchStyle.Cross
Text
包含标题文本外观格式特征。例如Font
Font按钮将授予访问字体对话框窗口,该窗口允许选择Windows字体和定义样式(斜体,粗体等)和颜色。
运行:
[C#.Net] tChart1.Header.Font.Name = "Verdana"; tChart1.Header.Font.Bold = true; [VB.Net] TChart1.Header.Font.Name = "Verdana" TChart1.Header.Font.Bold = True
Shadow
Shadow属性用于显示页眉或页脚框阴影。你可以定义颜色和ChartBrush[solid, hatch, gradient or image].
[C#.Net] tChart1.Header.Shadow.Visible = true; tChart1.Header.Shadow.Color = Color.Chartreuse; [VB.Net] TChart1.Header.Shadow.Visible = True TChart1.Header.Shadow.Color = Color.Chartreuse
Bevels
定义页眉或页脚框的Bevels属性。
Legend属性
Legend内容是一个专门的主题,将在后面的教程中处理。在图图编辑器的图例页面中,您可以定义图例的外观方面。重要的初始步骤是控制图例对齐和可见属性,颜色,字体,框架,阴影等。
Style
切换打开/关闭Legend显示并设置图例显示内容特征(包括复选框等)。
运行:
示例使用复选框控制Legend显示:
[C#.Net] private void checkBox1_CheckedChanged(object sender, System.EventArgs e) { if(checkBox1.Checked) {tChart1.Legend.Visible = true;} else {tChart1.Legend.Visible = false;} } [VB.Net] Private Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged If CheckBox1.Checked Then TChart1.Legend.Visible = True Else TChart1.Legend.Visible = False End If End Sub
%Dividing Lines
用于在图例项之间的图例框中绘制线条。ChartPen属性适用。
[C#.Net] tChart1.Legend.DividingLines.Visible = true; tChart1.Legend.DividingLines.Color = Color.Blue; [VB.Net] TChart1.Legend.DividingLines.Visible = True TChart1.Legend.DividingLines.Color = Color.Blue
Position
设置Legend的默认显示位置或启用图例的自定义定位。TeeChart将改变Legend的形状以适应位置。如果Legend设置在图表的一侧(左侧或右侧),则默认情况下,Legend的内容以从上到下的列表形式显示。如果Legend位于图表下方或上方,则内容并排放置。可以使用“调整图表大小”选项和/或使用“自定义定位”来覆盖默认行为。请参阅Legend教程了解更多关于Legend的自定义定位。
例如ResizeChart
调整图表大小定义图表在绘制图例时是否为图例留出空间。这允许Legend被放置在图表区域内。
[C#.Net] tChart1.Legend.ResizeChart = true; [VB.Net] TChart1.Legend.ResizeChart = True
%Top position
定义Legend框从图表面的顶部开始的位移。
[C#.Net] tChart1.Legend.CustomPosition = true; tChart1.Legend.Top = 5; [VB.Net] TChart1.Legend.CustomPosition = True TChart1.Legend.Top =
Symbols
Legend 符号的大小和格式。
%Color Width
定义Legend中颜色框的宽度。
运行:
[C#.Net] tChart1.Legend.Symbol.WidthUnits = LegendSymbolSize.Pixels; tChart1.Legend.Symbol.Width = 30; [VB.Net] TChart1.Legend.Symbol.WidthUnits = Steema.TeeChart.LegendSymbolSize.Pixels TChart1.Legend.Symbol.Width = 30
Format
包含Legend框的设置,例如颜色,框架(ChartPen属性),图案(ChartBrush属性),以及圆形框架和透明的复选框。
Text
文字特征为Legend文字内容及其阴影。
运行:
[C#.Net] private void button1_Click(object sender, System.EventArgs e) { Legend legend1; legend1 = tChart1.Legend; legend1.Color = Color.Blue; legend1.Font.Name = "Times New Roman"; legend1.Font.Color = Color.Yellow; } [VB.Net] Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click With TChart1.Legend .Color = Color.Blue .Font.Name = "Times New Roman" .Font.Color = Color.Yellow End With End Sub
Gradient
在Legend框中启用/禁用背景渐变,并选择其方向和颜色。
Shadow
属性用于显示Legend框阴影。你可以定义颜色,图案(ChartBrush)大小和透明度。
运行:
[C#.Net] tChart1.Legend.Shadow.Color = Color.Cyan; tChart1.Legend.Shadow.Width = 4; [VB.Net] TChart1.Legend.Shadow.Color = Color.Cyan TChart1.Legend.Shadow.Width = 4
Bevels
inner Bevels和outer bevels颜色和尺寸属性。
Panel Properties
TeeChart Panel允许您设置大大增强图表外观的参数。Panel渐变效果在支持真彩色的显示器上效果最好。
现在你已经熟悉了TeeChart的属性,所以我们不会在这里介绍所有的属性。Panel属性和方法可以通过Panel接口访问:
主要领域有:
Borders
您可以单独定义Border,也可以与Bevel属性一起定义Border。混合斜角和边界和操纵宽度几乎可以提供任何3D效果的组合。
例如:Bevel Inner/Bevel Outer/Border Width
这些属性将在图表面板的边框上产生各种3D效果。在设计时修改它们,以查看它们如何影响图表边框斜度。
Background
例如Panel Color
Panel颜色将用所选颜色绘制整个图表背景。如果你选择查看背景渐变或图像,它们将隐藏Panel颜色。如果您设置了背景颜色,它将只替换图表框架内的面板颜色。
例如BackImage
您可以选择任何位图文件作为背景图像。使用Hatch Brush编辑器(从Pattern按钮),有五种不同的Wrap模式供BackImage选择。
运行:
使用ChartBrush。在运行时为图表添加背景图像。
[C#.Net] tChart1.Panel.Brush.WrapMode = System.Drawing.Drawing2D.WrapMode.TileFlipXY; tChart1.Panel.Brush.LoadImage(@"C:\...\MyImage.jpg"); [VB.Net] TChart1.Panel.Brush.WrapMode = System.Drawing.Drawing2D.WrapMode.TileFlipXY TChart1.Panel.Brush.LoadImage("C:\...\MyImage.jpg")
Margins
定义为图表边框和图框之间的距离,并以图表面板整体尺寸的百分比表示。
移动图表编辑器边距框中的旋转框将在设计时显示更改每个边距的效果。
运行时属性是:
TChart1.Panel.MarginTop TChart1.Panel.MarginLeft TChart1.Panel.MarginRight TChart1.Panel.MarginBottom
你可以使用HScrollbar来改变这些属性:
[C#.Net] private void Form1_Load(object sender, System.EventArgs e) { bar1.FillSampleValues(10); hScrollBar1.Value = Convert.ToInt32(tChart1.Panel.MarginLeft); hScrollBar1.Maximum = 80; } private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) { tChart1.Panel.MarginLeft = Convert.ToDouble(e.NewValue); } [VB.Net] Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load Bar1.FillSampleValues(10) HScrollBar1.Value = TChart1.Panel.MarginLeft HScrollBar1.Maximum = 80 End Sub Private Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll TChart1.Panel.MarginLeft = e.NewValue End Sub
Gradient
要定义Gradient,你必须选择StartColor和EndColor(加上可选的MidColor),并启用Gradient可见。Gradient将覆盖整个图表Panel。Gradient方向定义了在Start, Mid和EndColor之间颜色变化的方向。
运行:
[C#.Net] tChart1.Panel.Gradient.Visible = true; tChart1.Panel.Gradient.StartColor = Color.Red; tChart1.Panel.Gradient.MiddleColor = Color.White; tChart1.Panel.Gradient.EndColor = Color.Blue; tChart1.Panel.Gradient.Direction = System.Drawing.Drawing2D.LinearGradientMode.ForwardDiagonal; [VB.Net] With TChart1.Panel .Gradient.Visible = True .Gradient.StartColor = Color.Red .Gradient.MiddleColor = Color.White .Gradient.EndColor = Color.Blue .Gradient.Direction = System.Drawing.Drawing2D.LinearGradientMode.ForwardDiagonal End With
Shadow
定义图表panel's shadow的大小、颜色、图案(ChartBrush)和透明度属性。
Paging属性
TeeChart paging允许将图表分成每页一定数量的点,并允许对图表进行翻阅。有关更多信息,请参阅 Paging教程。
Walls 属性
“图表编辑器”的“图表”部分中的此页将属性应用于Chart Walls。有4种Walls:Left, Right, Bottom and Back,可以用2D或3D表示。
Walls 属性可以通过TChart1. Walls property访问。
Color
Color按钮将带您到颜色编辑器,使您能够为所选墙壁选择颜色。
Border
Border按钮将带您到Walls类的ChartPen定义。这是许多其他TeeChart对象可用的相同的Pen。
visible属性启用/禁用边框的显示。在BackWall的情况下,轴是可见的,Wall Border将隐藏在这些轴的后面,所以你只能看到启用/禁用边界的结果,如果你隐藏了一些或所有的轴(例如,使轴的顶部和右侧不可见,以看到改变墙边界颜色的结果,即TChart1.Walls.Back.Pen。Color = Color. blue)。
有关边界笔的其他特性,请参阅ChartPen。您可以在设计时更改这些属性。
Pattern
Pattern按钮将带您到Walls类的ChartBrush定义。这是相同的刷可用于许多其他TeeChart对象。
Gradient
Gradient按钮将带您到渐变编辑器,使您能够为所选的wall选择渐变。
3D
3D在TeeChart Pro中是非常灵活的。现在,您可以选择将图表显示为:
- 2D平面图表,正面视角
- 3D Orthogonal,3D由矢量线表示,以表示深度
- 3D Native Windows, 3D使用具有180度图表旋转的3D画布
3 Dimensions
选择此属性(toggling)将在设计时将图表从3D更改为2D图表,并且该设置将在运行时生效。
3D %
控制3D效果的深度。更改此属性的值将在设计时显示更改3D百分比的效果。
这些属性的一个应用示例使用了CheckBox和Horizontal ScrollBar:
[C#.Net] private void checkBox1_CheckedChanged(object sender, System.EventArgs e) { if(checkBox1.Checked) { tChart1.Aspect.View3D = true; hScrollBar1.Enabled = true; } else { tChart1.Aspect.View3D = false; hScrollBar1.Enabled = false; } } private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) { tChart1.Aspect.Chart3DPercent = e.NewValue; } [VB.Net] Private Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged If CheckBox1.Checked Then TChart1.Aspect.View3D = True HScrollBar1.Enabled = True Else TChart1.Aspect.View3D = False HScrollBar1.Enabled = False End If End Sub Private Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll TChart1.Aspect.Chart3DPercent = e.NewValue End Sub
当禁用Orthogonal选项时,启用Windows Native 3D模式,能够使您旋转,增加和偏移图表。Zoom选项允许您向前或向后移动整个图表。在运行时,数据系列图表内部的Zoom仍然可用。
Perspective属性允许您设置距离透视图,就像查看房间一样。透视图为用于演示目的的图表提供了视觉增强。有关3D选项的进一步参考,请参阅教程 -Chart 3D。