【TeeChart .NET教程】(二)图表显示属性
【下载TeeChart.Net最新版本】
图表显示功能是影响图表整体外观的功能。它们包括定义图表背景颜色的属性和方法,标题及其位置,边距,边框和斜面,背景图像,框架和轴可见,笔颜色和宽度,3D,墙壁等。
几乎所有这些属性都是可以在设计或运行时通过TeeChart Editor获得,您可以在运行时以编程方式修改这些属性。整体图表外观特征分为以下类别:
- General:常规
- Axis:轴
- Titles:标题
- Legend:图例
- Panel:面板
- Paging:分页
- Walls:墙
- 3D
如果用户打开TeeChart编辑器并浏览图表页面,则可以找到这些分组。其他属性会影响图表的“外观”。这些包括系列颜色和标记特征,单独的轴和网格显示属性和标签。这些将在稍后专门介绍这些功能的专家角色的教程中处理。
图表显示属性入门
向表单添加一个新图表,将看到它以3D显示,带有灰色面板背景,2个墙(底部和左侧),框架(定义图表可绘制区域的框架)和默认值图表标题标题“TeeChart”。
右键单击图表并从菜单中选择“Edit ...”以访问TeeChart编辑器。第一页是系列页面,它是空的。选择第三个“图表”选项卡“常规”以访问“常规图表”属性页面。
常规图表属性
常规选项包括以下3个部分:
- Zoom :缩放
- Scroll :滚动
- Cursor :光标
Axis:轴属性
在最复杂的复杂程度上,轴的控制是一个非常专业的领域,并在后面的教程中进行更深入的处理。在这里,我们将介绍Axis和Frame显示的基础知识。
第二个Chart页面包含用于定义轴和框架特征的属性。
图表中有6个主轴。左,上,右,下,深度底部和深度顶部。图表框显示为图表可绘制区域的环绕,并且没有数据对应的功能。默认情况下,Depth初始化为不可见。从系列添加到图表并与这些轴关联的那一刻(默认为左和底),所有其他轴都可见。可以使用对话框上的+和 - 键添加/删除自定义轴。要使自定义轴可见(与任何其他轴一样),系列必须与轴关联。有关自定义轴的更多信息,请参见Axis教程。
启用轴和框架显示的关键属性是:
Visible
此复选框启用或禁用所有轴的显示。如果后墙框架可见,则隐藏轴时图表环绕仍然可见。结果将是更大的图表的外观,因为没有为轴标签保留区域。每个轴(“标尺”选项卡)的“可见”属性将覆盖每个轴的可见特征。如果在列表中选择深度轴,则会注意到Depth Axis Scales.Visible默认为“'not visible”。
[C#.Net]
tChart1.Axes.Visible = true;
[VB.Net]
TChart1.Axes.Visible = True
轴:左,右,上,下和深可见
选择要在列表框中显示或隐藏的轴,并在“比例”选项卡上切换“visible”复选框以控制该特定轴的显示。
[C#.Net]
tChart1.Axes.Left.Visible = true;
[VB.Net]
TChart1.Axes.Left.Visible = True
Title:标题
TeeChart Editor的Titles页面控制图表标题,页眉和页脚的特征。
Text
使用下拉组合框选择标题(标题),子标题,英尺或子图标。在文本框中输入所需的文本。您可以输入多行标题。
运行时:
Header类的Text属性是标准的.Net String类,可以这样修改,例如:
[C#.Net]
tChart1.Header.Text = "My Header Text";
[VB.Net]
TChart1.Header.Text = "My Header Text"
样式对齐
对齐是指与图表区域相对的页眉(或页脚)对齐而不是整个图表面板。图表区域是图表加轴标签和图例的可绘图区域。
Runtime:
[C#.Net]
tChart1.Header.Alignment = StringAlignment.Far;
[VB.Net]
TChart1.Header.Alignment = StringAlignment.Far
Position:位置
使用位置覆盖标题或页脚默认位置并设置自定义位置(与图表顶部,左侧的像素关系)。
Runtime:
[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:格式
包含“标题”框的设置,例如框的颜色,框周围框的笔属性,框的画笔属性[图案]等。例如,图案,模式是指背景图案[实心,阴影,渐变或标题或页脚框的图像]。
默认值为“Transparent:透明”,表示在取消选中“透明”复选框之前,“标题”框不可见。
Runtime:
[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:文本
包含标题文本外观格式特征。例如,字体:字体按钮将授予对“字体对话框”窗口的访问权限,该窗口允许选择Windows字体和样式(斜体,粗体等)和颜色的定义。
Runtime:
[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:阴影
属性,用于显示页眉或页脚框阴影。您可以定义颜色和ChartBrush [solid,hatch,gradient或image]。
Runtime:
[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:斜杠
定义页眉或页脚框的斜角属性。
Legend:图例
图例内容是专业主题,将在后面的教程中处理。在TeeChart Editor的Legend页面中,用户可以定义Legend的外观方面。重要的初始步骤是控制图例对齐和可见属性,颜色,字体,框架,阴影等。
Style:样式
切换开/关图例显示和设置图例显示内容特征(包括复选框等)。
Runtime:
使用复选框控制图例显示的示例:
[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
%Divided Lines:用于在Legend条目之间的Legend框中绘制线条。ChartPen属性适用。
Runtime:
[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:位置
设置默认显示位置或启用图例的自定义位置。TChart将改变图例的形状以适合该位置。如果图例设置为图表的侧面(左侧或右侧),默认情况下,图例的内容将从上到下列为列表。如果图例位于图表下方或上方,则图例内容并排放置。可以使用“调整大小图表”选项和/或使用“自定义”定位来覆盖默认行为。有关Legend的自定义定位的更多信息,请参阅Legend教程。
例如,ResizeChart
Resize Chart定义图表在绘制时是否为Legend留出空间。这允许图例放置在图表区域内。
Runtime:
[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
%顶部位置:定义图表面板顶部的图例框位移。
Runtime:
[C#.Net]
tChart1.Legend.CustomPosition = true; tChart1.Legend.Top = 5;
[VB.Net]
TChart1.Legend.CustomPosition = True TChart1.Legend.Top = 5
Symbols
图例符号的大小和格式。
%颜色宽度:定义图例中颜色框的宽度。
Runtime:
[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:格式
包含“图例”框的设置,例如“颜色”,“框架”(ChartPen属性),“图案”(ChartBrush属性)以及“圆形框架”和“透明”的复选框。
Text:文本
文本内容及其阴影的文本特征。
Runtime:
[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:渐变
在“图例”框中启用/禁用“背景渐变”,然后选择其方向和颜色。
Shadow:阴影
属性用于显示“图例”框阴影。您可以定义颜色,图案(ChartBrush)大小和透明度。
Runtime:
[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:斜面
属性为内,外斜面颜色和大小。
Panel:面板
TeeChart Panel页面允许用户设置参数,从而大大增强图表的外观。面板渐变效果最适合支持真彩色的显示器,可以通过Panel界面访问面板属性和方法:
关键区域是:
Borders:边框
用户可以单独定义边框,也可以与“倒角”属性一起定义边框。混合斜角和边框以及操纵宽度几乎可以提供任何3D效果组合。例如斜角内/斜角外/边框宽度
这些属性将在“图表”边框的面板上生成各种3D效果。在设计时修改它们以查看它们如何影响图表边框斜面。
Background:背景
例如:面板颜色,面板颜色将使用所选颜色绘制整个图表背景。如果选择查看背景渐变或图像,则会隐藏面板颜色。如果设置背面颜色,它将仅替换图表框架中的面板颜色。
例如:BackImage用户可以选择任何位图文件作为BackImage。使用Hatch Brush Editor(来自Pattern按钮)有五种不同的Wrap模式可供BackImage选择。
Runtime:
使用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")
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渐变
要定义渐变,必须选择StartColor和EndColor(加上,可选择MidColor)并启用“Visible the Gradient:可见渐变”。Gradient将覆盖整个Chart面板。渐变方向定义Start,Mid和EndColor之间的颜色变化方向。
Runtime:
[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:阴影
定义“图表”面板阴影的大小,颜色,图案(ChartBrush)和透明度属性。
Paging:分页
TeeChart分页允许将图表划分为每页的设定点数和图表。
Walls
图表编辑器的“图表”部分中的此页面将属性应用于图表墙。有4个墙:左,右,下和后,可以用2D或3D表示,可以通过TChart1.Walls属性访问Walls属性。
Color:颜色
“颜色”按钮转到“颜色编辑器”,使用户可以选择所选墙的颜色。
Border:边框
边框按钮转到Walls类的ChartPen定义。
visible属性启用/禁用Border的显示。对于BackWall,其中轴是可见的,墙边框将隐藏在这些轴后面,因此如果隐藏部分或全部轴,用户将只看到启用/禁用边框的结果(例如,使轴顶部和右侧不可见改变Wall Border颜色的结果,即TChart1.Walls.Back.Pen.Color = Color.Blue)。
有关Border Pen的其他特征,请参见ChartPen。用户可以在设计时更改这些属性。
Pattern
Pattern按钮:Walls类的ChartBrush定义。这与许多其他TeeChart对象相同。
Gradient
渐变按钮:“渐变编辑器”,您可以选择所选墙的渐变。
3D
3D在TeeChart Pro中非常灵活,可以选择将图表显示为:
- 2D平面图,从正面??看
- 由矢量线表示的3D正交3D表示深度
- 使用3D画布的3D原生Windows 3D,180度图表旋转
3 Dimensions
选择此属性(切换)将在设计时将图表从3D更改为2D图表,该设置将在运行时生效。
3D%
控制3D效果的深度。更改此属性的值将在设计时显示更改3D百分比的效果。
这些属性的应用示例使用CheckBox和Horizo??ntal 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
选项在禁用时启用Windows Native 3D模式,允许用户旋转,提升和偏移图表。“缩放”选项允许前移或移开整个图表。数据系列图表内部的缩放在运行时仍然可用。
Perspective属性允许设置距离透视图。Perpsective为用于演示目的的图表提供了视觉增强功能。