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

(二)图表显示属性


【下载TeeChart.Net最新版本】

图表显示功能是影响图表整体外观的功能。它们包括定义图表背景颜色的属性和方法,标题及其位置,边距,边框和斜面,背景图像,框架和轴可见,笔颜色和宽度,3D,墙壁等。
几乎所有这些属性都是可以在设计或运行时通过TeeChart Editor获得,您可以在运行时以编程方式修改这些属性。整体图表外观特征分为以下类别:

  • General:常规
  • Axis:轴
  • Titles:标题
  • Legend:图例
  • Panel:面板
  • Paging:分页
  • Walls:墙
  • 3D

如果用户打开TeeChart编辑器并浏览图表页面,则可以找到这些分组。其他属性会影响图表的“外观”。这些包括系列颜色和标记特征,单独的轴和网格显示属性和标签。这些将在稍后专门介绍这些功能的专家角色的教程中处理。

图表显示属性入门

向表单添加一个新图表,将看到它以3D显示,带有灰色面板背景,2个墙(底部和左侧),框架(定义图表可绘制区域的框架)和默认值图表标题标题“TeeChart”。

右键单击图表并从菜单中选择“Edit ...”以访问TeeChart编辑器。第一页是系列页面,它是空的。选择第三个“图表”选项卡“常规”以访问“常规图表”属性页面。

常规图表属性

TeeChart.Net

常规选项包括以下3个部分:

  • Zoom :缩放
  • Scroll :滚动
  • Cursor :光标

Axis:轴属性

在最复杂的复杂程度上,轴的控制是一个非常专业的领域,并在后面的教程中进行更深入的处理。在这里,我们将介绍Axis和Frame显示的基础知识。

第二个Chart页面包含用于定义轴和框架特征的属性。

teema

图表中有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页面控制图表标题,页眉和页脚的特征。

teechart
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:格式

包含“标题”框的设置,例如框的颜色,框周围框的笔属性,框的画笔属性[图案]等。例如,图案,模式是指背景图案[实心,阴影,渐变或标题或页脚框的图像]。

teechart

默认值为“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的外观方面。重要的初始步骤是控制图例对齐和可见属性,颜色,字体,框架,阴影等。

teechart
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界面访问面板属性和方法:

Teechart

关键区域是:

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分页允许将图表划分为每页的设定点数和图表。

teechart

Walls

图表编辑器的“图表”部分中的此页面将属性应用于图表墙。有4个墙:左,右,下和后,可以用2D或3D表示,可以通过TChart1.Walls属性访问Walls属性。

teechart
Color:颜色

“颜色”按钮转到“颜色编辑器”,使用户可以选择所选墙的颜色。

Border:边框

边框按钮转到Walls类的ChartPen定义。

teechart

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度图表旋转
teechart
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为用于演示目的的图表提供了视觉增强功能。