TeeChart for .NET图表控件教程：图表显示属性

图表显示特性是那些影响图表整体外观的特性，可以在运行时以编程方式修改这些属性。整个图表的外观特征被归为以下几类。

TeeChart for .NET是优秀的工业4.0 WinForm图表控件，官方独家授权汉化，集功能全面、性能稳定、价格实惠等优势于一体。TeeChart for .NET 中文版还可让您在使用和学习上没有任何语言障碍，至少可以节省30%的开发时间。

点击立即下载最新版TeeChart for .NET

图表显示特性是那些影响图表整体外观的特性。它们包括那些定义图表背景颜色、标题及其位置、边距、边框和斜面、背景图像、框架和轴的可见性、笔的颜色和宽度、3D、墙等等的属性和方法。

• 常规 
• 轴 
• 标题 
• 图例 
• 面板 
• 分页 
• 墙面 
• 3D 

开始使用图表显示属性 

一般图表属性

一般选项包括以下三个部分。

• 缩放 
• 滚动 
• 光标 

缩放和滚动将在后面的教程中论述。

轴属性 

轴的控制是一个相当专业的领域，其复杂程度最高，在后面的教程中会有更深入的论述。这里我们将介绍轴和框架显示的基本原理。

第二个图表页面拥有定义轴和框架特性的属性。

在图表中，有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页面控制着图表标题、页眉和页脚的特性。

文本 

使用下拉组合框选择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 = TrueTChart1.Header.Top = TChart1.Header.Top + 10

格式化 

包含标题框的设置，例如：框的颜色、框周围的笔属性、框的刷子属性[图案]等。
例如：图案 
图案指的是标题或页脚框的背景图案[实心、填充、渐变或图像]。

默认是透明的，意味着在取消透明复选框之前，标题框是不可见的。
运行时

[C#.Net]tChart1.Header.Transparent = false。tChart1.Header.Brush.Style = System.Drawing.Drawing2D.HatchStyle.Cross; [VB.Net]TChart1.Header.Transparent = FalseTChart1.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 = TrueTChart1.Header.Shadow.Color = Color.Chartreuse. 

斜面 
定义页眉或页脚框的斜面属性。

图例属性 
图例内容是一个专业课题，将在以后的教程中讨论。在TeeChart Editor的Legend页面中，你可以定义Legend的外观方面。重要的初始步骤是控制图例对齐和可见属性、颜色、字体、框架、阴影等。

样式 

切换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 IfEnd Sub 

分割线 
用于在Legend盒内的Legend条目之间画线。ChartPen属性适用。
运行时间

[C#.Net]tChart1.Legend.DividingLines.Visible = true;tChart1.Legend.DividingLines.Color = Color.Blue;[VB.Net]TChart1.Legend.DividingLines.Visible = TrueTChart1.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 = TrueTChart1.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.PixelsTChart1.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 WithEnd Sub 

梯度 

在图例框中启用/禁用一个背景渐变，并选择其方向和颜色。

阴影 
用于显示图例框阴影的属性。你可以定义颜色、图案（ChartBrush）大小和透明度。
运行时间

[C#.Net]tChart1.Legend.Shadow.Color = Color.Cyan;tChart1.Legend.Shadow.Width = 4;[VB.Net]TChart1.Legend.Shadow.Color = Color.CyanTChart1.Legend.Shadow.Width = 4 

斜面 
内部和外部斜面的颜色和大小的属性。

面板属性 

TeeChart面板页面允许你设置参数，这些参数可以大大增强图表的外观。面板的渐变效果在支持真彩色的显示器上看得最清楚。

现在你已经熟悉了TeeChart的属性，所以我们不在这里介绍所有的属性。面板属性和方法可以通过面板接口访问。

关键领域是

边界 

你可以独立定义边框，也可以与斜面属性结合起来。混合使用斜面和边框并操作宽度，几乎可以得到任何三维效果的组合。

例如：内斜面/外斜面/边框宽度 
这些属性将在图表面板的边框上产生各种三维效果。在设计时修改它们，看看它们如何影响图表边框的斜面。

背景 

例如：面板颜色 
面板颜色将用选择的颜色涂抹整个图表背景。如果你选择查看背景渐变或图像，它们将隐藏面板的颜色。如果你设置了一个背景颜色，它将仅在图表框架内取代面板颜色。

例如：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.TileFlipXYTChart1.Panel.Brush.LoadImage("C:...MyImage.jpg") 

边距 

TChart1.Panel.MarginTop TChart1.Panel.MarginLeftTChart1.Panel.MarginRightTChart1.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 = 80End SubPrivate Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll        TChart1.Panel.MarginLeft = e.NewValueEnd 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.ForwardDiagonalEnd With

阴影 
定义图表面板阴影的大小、颜色、图案（ChartBrush）和透明度属性。

分页属性 

TeeChart分页允许一个Chart在每页被分成一个设定的点数，并且允许Chart被翻阅。请参阅分页教程以了解更多信息。

墙的属性 

墙的属性可以通过TChart1.Walls属性访问。

边框 
边界按钮将带你到Walls类的ChartPen定义。这与许多其他TeeChart对象可用的笔相同。

可见属性启用/禁用边界的显示。在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 IfEnd Sub 

当禁用正交选项时，可以启用Windows本地3D模式，允许你旋转、提升和偏移图表。缩放选项允许你将整个图表向前或向外移动。在数据系列的图表中，内部缩放在运行时仍然可用。

Perspective属性允许你设置一个距离透视，就像看一个房间一样。透视为用于演示的图表提供了一种视觉增强。对于3D选项的进一步参考，请看教程15–图表3D。

---

现TeeChart for .NET已加入在线订购，现在抢购可立享优惠！

如果您对该图表控件感兴趣，欢迎加入图表控件QQ交流群：

标签：