TeeChart for .NET图表控件显示属性
TeeChart for .NET是优秀的工业4.0 WinForm图表控件,官方独家授权汉化,集功能全面、性能稳定、价格实惠等优势于一体。TeeChart for .NET 中文版还可让您在使用和学习上没有任何语言障碍,至少可以节省30%的开发时间。
【慧都网】免费下载TeeChart for .NET最新试用版
图表显示特性是那些影响图表整体外观的特性。它们包括那些定义图表背景颜色、标题及其位置、边距、边框和斜面、背景图像、框架和轴的可见性、笔的颜色和宽度、3D、墙等等的属性和方法。
几乎所有的这些属性都可以在设计或运行时通过TeeChart编辑器使用,你可以在运行时以编程方式修改这些属性。整个图表的外观特征被归为以下几类。
- 常规
- 轴
- 标题
- 图例
- 面板
- 分页
- 墙面
- 3D
如果你打开TeeChart编辑器并浏览图表页面,你会发现这些分组。其他属性影响你的图表的 "外观"。这些属性包括系列颜色和标记特征、个别轴和网格显示属性和标签。这些将在以后的教程中专门讨论这些特性的专业作用。
开始使用图表显示属性
在表格中添加一个新的图表,你会看到它以3D方式显示,有灰色的面板背景,2个墙(底部和左侧),框架(定义了图表可规划区域的框架)和一个默认的图表标题 "TeeChart"。
在图表上点击右键,从菜单中选择 "编辑... "来访问TeeChart编辑器。第一页是 "系列 "页,它是空的,我们对这个教程不感兴趣。选择第三个图表标签 "常规",进入常规图表属性页。
一般图表属性
一般选项包括以下三个部分。
- 缩放
- 滚动
- 光标
缩放和滚动将在后面的教程中论述。
轴属性
轴的控制是一个相当专业的领域,其复杂程度最高,在后面的教程中会有更深入的论述。这里我们将介绍轴和框架显示的基本原理。
第二个图表页面拥有定义轴和框架特性的属性。
![](https://steema.com/docs/teechart/net/tutorials/html/images/Image60.png)
在图表中,有6个主要的轴。左、上、右、下、深度下和深度上。图表框架显示为图表可绘图区域的周围,没有数据对应的特征(参见BackWall)。深度的初始化默认为不可见。所有其他轴在系列被添加到图表并与这些轴(默认为左侧和底部)相关联的时刻是可见的。自定义轴可以通过对话中的+和-键进行添加/删除。为了使自定义坐标轴可见(就像其他坐标轴一样),必须将一个系列与该坐标轴关联。关于自定义轴的更多信息,请参见 "轴 "教程。
启用显示轴和框架的关键属性是。
可见
此复选框可以启用或禁用所有轴的显示。如果后墙框架是可见的,那么当轴被隐藏时,图表周围仍然是可见的。其结果是,由于没有为轴标签保留区域,所以图表的外观会更大。每个轴的可见属性(Scales标签)覆盖了每个轴的可见特性。如果你在列表中选择深度轴,那么你会注意到深度轴Scales.Visible默认为 "不可见"。
[C#.Net]
tChart1.Axes.Visible = true;
[VB.Net]
TChart1.Axes.Visible = True
轴:左、右、顶、底和深度可见
选择你想在列表框中显示或隐藏的轴,并在Scales标签上切换Visible复选框来控制该特定轴的显示。
[C#.Net]
tChart1.Axes.Left.Visible = true;
[VB.Net]
TChart1.Axes.Left.Visible = True
标题属性
TeeChart Editor的Titles页面控制着图表标题、页眉和页脚的特性。
![](https://steema.com/docs/teechart/net/tutorials/html/images/EDITTTLE.png)
文本
使用下拉组合框选择Title(标题)、SubTitle、Foot或SubFoot。在文本框中输入所需的文本。你可以输入多行标题。
运行时
Header类的Text属性是一个标准的.Net字符串类,可以照此修改,比如说
[C#.Net]
tChart1.Header.Text = "My Header Text";
[VB.Net]
TChart1.Header.Text = "我的标题文本"
样式排列
对齐是指相对于图表区域的标题(或页脚)对齐,而不是整个图表面板。图表区域是指图表的可标示区域以及轴标签和图例。
运行时
[C#.Net]
tChart1.Header.Alignment = StringAlignment.Far;
[VB.Net]
TChart1.Header.Alignment = StringAlignment.Far
位置
使用Position来覆盖Title或Footer的默认位置,并设置一个自定义的位置(与Chart Top, Left的像素关系)。
运行时
[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
格式化
包含标题框的设置,例如:框的颜色、框周围的笔属性、框的刷子属性[图案]等。
例如:图案
图案指的是标题或页脚框的背景图案[实心、填充、渐变或图像]。
![](https://steema.com/docs/teechart/net/tutorials/html/images/EDITPATT.png)
默认是透明的,意味着在取消透明复选框之前,标题框是不可见的。
运行时
[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.
文本
包含标题文本的外观格式特征。
例如:字体
字体按钮将允许访问字体对话框窗口,该窗口允许选择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
阴影
用于显示页眉或页脚框阴影的属性。你可以定义颜色和ChartBrush[实心、填充、渐变或图像]。
运行时
[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.
斜面
定义页眉或页脚框的斜面属性。
图例属性
图例内容是一个专业课题,将在以后的教程中讨论。在TeeChart Editor的Legend页面中,你可以定义Legend的外观方面。重要的初始步骤是控制图例对齐和可见属性、颜色、字体、框架、阴影等。
![](https://steema.com/docs/teechart/net/tutorials/html/images/EDITLEGD.png)
样式
切换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
分割线
用于在Legend盒内的Legend条目之间画线。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
位置设置
设置默认的显示位置或启用Legend的自定义定位。TChart将改变Legend的形状以适应该位置。如果Legend被设置在图表的侧面(左边或右边),Legend的内容默认为从上到下的列表。如果图例位于图表的下方或上方,那么图例内容将被并排放置。默认行为可以通过使用调整图表大小选项和/或使用自定义定位来覆盖。关于图例的自定义定位的更多信息,请参见图例教程。
例如:调整图表大小(ResizeChart
调整图表大小定义了图表在绘制时是否会给图例留下空间。这使得Legend可以被放置在Chart区域内。
运行时
[C#.Net] tChart1.Legend.ResizeChart = true。 [VB.Net] TChart1.Legend.ResizeChart = True
%顶部位置
定义Legend框从图表面板顶部的位移。
运行时
[C#.Net] tChart1.Legend.CustomPosition = true; tChart1.Legend.Top = 5; [VB.Net] TChart1.Legend.CustomPosition = True TChart1.Legend.Top = 5
符号
图例符号的大小和格式化。
%颜色宽度
定义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
格式
包含图例框的设置,例如颜色、框架(ChartPen属性)、图案(ChartBrush属性),以及圆形框架和透明的复选框。
文本
图例文本内容及其阴影的文本特征。
运行时间
[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
梯度
在图例框中启用/禁用一个背景渐变,并选择其方向和颜色。
阴影
用于显示图例框阴影的属性。你可以定义颜色、图案(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
斜面
内部和外部斜面的颜色和大小的属性。
面板属性
TeeChart面板页面允许你设置参数,这些参数可以大大增强图表的外观。面板的渐变效果在支持真彩色的显示器上看得最清楚。
现在你已经熟悉了TeeChart的属性,所以我们不在这里介绍所有的属性。面板属性和方法可以通过面板接口访问。
![](https://steema.com/docs/teechart/net/tutorials/html/images/EDITPANL.png)
关键领域是
边界
你可以独立定义边框,也可以与斜面属性结合起来。混合使用斜面和边框并操作宽度,几乎可以得到任何三维效果的组合。
例如:内斜面/外斜面/边框宽度
这些属性将在图表面板的边框上产生各种三维效果。在设计时修改它们,看看它们如何影响图表边框的斜面。
背景
例如:面板颜色
面板颜色将用选择的颜色涂抹整个图表背景。如果你选择查看背景渐变或图像,它们将隐藏面板的颜色。如果你设置了一个背景颜色,它将仅在图表框架内取代面板颜色。
例如:BackImage
你可以选择任何位图文件作为BackImage。使用Hatch Brush Editor(来自Pattern按钮),有五种不同的Wrap模式可供BackImage选择。
运行时
使用ChartBrush.LoadImage可以在运行时为图表添加背景图片。
[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")
边距
边距被定义为图表边框和图表框架之间的距离,以图表面板整体尺寸的百分比表示。
移动 "图表编辑器 "边距框中的旋转框,将在设计时向你显示改变每个边距的效果。
运行时的属性是
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
梯度
要定义一个梯度,你必须选择一个开始颜色和结束颜色(加上可选的中间颜色),并启用梯度的可见性。渐变将覆盖整个图表面板。渐变方向定义了开始、中间和结束颜色之间的颜色变化方向。
运行时
[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.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.Drawing2D.LinearGradientMode.ForwardDiagonal End With
阴影
定义图表面板阴影的大小、颜色、图案(ChartBrush)和透明度属性。
分页属性
TeeChart分页允许一个Chart在每页被分成一个设定的点数,并且允许Chart被翻阅。请参阅分页教程以了解更多信息。
墙的属性
在图表编辑器的图表部分,这一页将属性应用于图表墙。有4个墙。左边、右边、下面和后面,可以用2D或3D表示。
墙的属性可以通过TChart1.Walls属性访问。
颜色
颜色按钮将带你到颜色编辑器,使你能够为选定的墙选择颜色。
边框
边界按钮将带你到Walls类的ChartPen定义。这与许多其他TeeChart对象可用的笔相同。
![](https://steema.com/docs/teechart/net/tutorials/html/images/Image61.png)
可见属性启用/禁用边界的显示。在BackWall的情况下,如果轴是可见的,Wall Border将隐藏在这些轴的后面,所以如果你隐藏了一些或所有的轴,你将只能看到启用/禁用Border的结果(例如,使轴Top和Right不可见,以看到改变Wall Border颜色的结果,即TChart1.Walls.Back.Pen.Color = Color.Blue)。
关于边框笔的其他特性,见ChartPen。你可以在设计时改变这些属性。
图案
图案按钮将带你到Walls类的ChartBrush定义。这与许多其他TeeChart对象可用的画笔相同。
梯度
渐变按钮将带你到渐变编辑器,使你能够为选定的墙选择一个渐变。
3D
3D在TeeChart Pro中是非常灵活的。你现在可以选择将图表显示为。
- 二维平面图,从正面看
- 三维正交三维,由矢量线表示,表示深度
- 使用3D画布的3D原生Windows 3D,图表旋转180度
3 尺寸
选择这个属性(切换)将在设计时把图表从三维变为二维,设置将在运行时生效。
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
当禁用正交选项时,可以启用Windows本地3D模式,允许你旋转、提升和偏移图表。缩放选项允许你将整个图表向前或向外移动。在数据系列的图表中,内部缩放在运行时仍然可用。
Perspective属性允许你设置一个距离透视,就像看一个房间一样。透视为用于演示的图表提供了一种视觉增强。对于3D选项的进一步参考,请看教程15--图表3D。
如果您对该图表控件感兴趣,欢迎加入图表控件QQ交流群:740060302
关注慧聚IT微信公众号☟☟☟,了解产品的最新动态及最新资讯。