【TeeChart .NET教程】（十八）：TeeChart工具集合（下）——轴工具

---

【下载TeeChart.Net最新版本】

轴工具

1 轴箭头工具

轴箭头工具在轴的起点和终点显示可配置的箭头，可以使这些箭头在单击时滚动轴。

设计时：

添加箭头工具后，您可以使用多个选项，轴可以选择要与轴工具关联的轴（顶部，底部，左侧，右侧或自定义），您可以添加多个轴工具，并将每个轴工具与不同的轴相关联。边框（笔编辑器）允许您配置笔的样式，颜色，宽度，结束，透明度和可见性，勾勒出箭头形状，而填充（填充画笔编辑器）允许您配置箭头的主体，它的颜色，透明度，可见性，填充样式，填充渐变或填充图像。长度以像素为单位描述箭头的长度，“Position”定义是否在轴的“End”，“Start”或“Both”绘制箭头，

运行时：

在运行时添加如下代码：

[C#]

private void Form1_Load(object sender, System.EventArgs e)  
        Bar bar1 = new Bar(tChart1.Chart); 
        AxisArrow axisArrow1 = new AxisArrow(tChart1.Chart); 
        axisArrow1.Active = true; 
        axisArrow1.Axis = tChart1.Axes.Left; 
 
        bar1.FillSampleValues(20); 

[VB.Net]

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 
        Dim Bar1 As New Steema.TeeChart.Styles.Bar(TChart1.Chart) 
        Dim AxisArrow1 As New Steema.TeeChart.AxisArrow(TChart1.Chart) 
        AxisArrow1.Active = True 
        AxisArrow1.Axis = TChart1.Axes.Left 
 
        Bar1.FillSampleValues(20) 
End Sub

2 颜色频带工具

色带工具也增加了可配置的颜色带由表轴包围的内部区域。这些带可以垂直或水平设置，与轴值一致。

设计时：

将色带工具添加到图表后，有许多选项可以配置它们。轴可以选择要将色带关联到的轴（顶部，底部，左侧或右侧）。边框（笔编辑器）允许您配置笔的样式，颜色，宽度，结束，透明度和可见性，勾勒出箭头形状，而填充（填充画笔编辑器）允许您配置箭头的主体，它的颜色，透明度，可见性，填充样式，填充渐变或填充图像。渐变定义颜色带渐变的可见性，方向和开始，中间和结束颜色，而在没有渐变或图像的情况下，颜色定义颜色。起始值设置颜色带工具将从其开始的指定轴上的起始值，结束值设置结束值。

运行时：

色带工具对于突出显示系列中的一组特定值非常有用。在这个例子中，我们使用了一个颜色带工具，它在两个动态指定的Y值之间进行扩展，并且滚动条可以改变其透明度。色带可以在TeeChart系列的前面或后面绘制。在运行时添加如下代码：

[C#]

private void Form1_Load(object sender, System.EventArgs e)  
        AreaSeries area1 = new AreaSeries(tChart1.Chart); 
        ColorBand colorband1 = new ColorBand(tChart1.Chart); 
        tChart1.Aspect.View3D = false; 
        tChart1.Panel.Gradient.Visible = true; 
        tChart1.Panel.Gradient.StartColor = Color.Blue; 
        tChart1.Panel.Gradient.MiddleColor = Color.Gray; 
        tChart1.Panel.Gradient.EndColor = Color.Green; 
 
        area1.LinePen.Color = Color.Blue; 
        area1.FillSampleValues(20); 
 
        double offSet = area1.YValues.Maximum * 0.1; 
        colorband1.Active = true; 
        colorband1.Axis = tChart1.Axes.Left; 
        colorband1.Transparency = 50; 
        colorband1.Start = area1.YValues.Minimum + offSet; 
        colorband1.End = area1.YValues.Maximum - offSet; 
        colorband1.DrawBehind = false; 
        hScrollBar1.Value = 50; 
 
 
private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e)  
        ((ColorBand)tChart1.Tools[0]).Transparency = e.NewValue; 
     
 
private void checkBox1_CheckedChanged(object sender, System.EventArgs e)  
        ((ColorBand)tChart1.Tools[0]).DrawBehind = !((ColorBand)tChart1.Tools[0]).DrawBehind;

[VB.Net]

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 
        Dim Area1 As New Steema.TeeChart.Styles.Area(TChart1.Chart) 
        Dim Colorband1 As New Steema.TeeChart.ColorBand(TChart1.Chart) 
        TChart1.Aspect.View3D = False 
        TChart1.Panel.Gradient.Visible = True 
        TChart1.Panel.Gradient.StartColor = Color.Blue 
        TChart1.Panel.Gradient.MiddleColor = Color.Gray 
        TChart1.Panel.Gradient.EndColor = Color.Green 
 
        Area1.LinePen.Color = Color.Blue 
        Area1.FillSampleValues(20) 
 
        Dim OffSet As Double = Area1.YValues.Maximum * 0.1 
        Colorband1.Active = True 
        Colorband1.Axis = TChart1.Axes.Left 
        Colorband1.Transparency = 50 
        Colorband1.Start = Area1.YValues.Minimum + OffSet 
        Colorband1.End = Area1.YValues.Maximum - OffSet 
        Colorband1.DrawBehind = False 
        HScrollBar1.Value = 50 
End Sub 
 
Private Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll 
        CType(TChart1.Tools(0), Steema.TeeChart.ColorBand).Transparency = e.NewValue 
End Sub 
 
Private Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged 
        CType(TChart1.Tools(0), Steema.TeeChart.ColorBand).DrawBehind = Not CType(TChart1.Tools(0), Steema.TeeChart.ColorBand).DrawBehind 
End Sub 

3 颜色线工具

颜色线工具在图表中添加彩色线条，可以垂直或水平设置与轴值一致

设计时：

ColorLines可以与特定系列值的特定轴相关联。边框（笔编辑器）允许您配置笔的样式，颜色，宽度，结尾，透明度和可见性，允许拖动启用拖动，拖动重绘重绘图表，同时拖动ColorLine工具，无拖动限制允许ColorLine拖动超出图表的轴，Draw Behind在Chart Series后面绘制ColorLine，而Draw3D在3D中绘制ColorLine。

运行时：

在运行时添加如下代码：

[C#]

Bar bar1 = new Bar(tChart1.Chart); 
ColorLine colorLine1 = new ColorLine(tChart1.Chart); 
 
bar1.FillSampleValues(20); 
colorLine1.Active = true; 
colorLine1.AllowDrag = true; 
colorLine1.Axis = tChart1.Axes.Left; 
colorLine1.Pen.Color = Color.Blue; 
colorLine1.Value = bar1.YValues.Maximum / 2;

[VB.Net]

Dim Bar1 As New Steema.TeeChart.Styles.Bar(TChart1.Chart) 
Dim ColorLine1 As New Steema.TeeChart.ColorLine(TChart1.Chart) 
 
Bar1.FillSampleValues(20) 
ColorLine1.Active = True 
ColorLine1.AllowDrag = True 
ColorLine1.Axis = TChart1.Axes.Left 
ColorLine1.Pen.Color = Color.Blue 
ColorLine1.Value = Bar1.YValues.Maximum / 2 

4 网格带工具

网格带工具在指定轴和位置的网格线处显示彩色矩形（带）。

设计时：

使用轴组合框选择要与工具关联的轴，可以分别使用“bush”和“color”按钮指定每个波段的布什和颜色特征。

运行时：

在运行时添加如下代码：

[C#]

GridBand tool = new GridBand(tChart1.Chart); 
Line line = new Line(tChart1.Chart); 
line.FillSampleValues(); 
 
tool.Axis = tChart1.Axes.Left; 
tool.Band1.Color = Color.Red; 
tool.Band2.Color = Color.White;

[VB.Net]

Dim tool As GridBand = New GridBand(TChart1.Chart) 
Dim line As Line = New Line(TChart1.Chart) 
line.FillSampleValues() 
 
tool.Axis = TChart1.Axes.Left 
tool.Band1.Color = Color.Red 
tool.Band2.Color = Color.White

5 轴滚动工具

轴滚动工具通过鼠标拖动来滚动轴的滚动。

设计时：

使用轴组合框选择要与工具关联的轴。

运行时：

在运行时添加如下代码：

[C#]

AxisScroll tool = new AxisScroll(tChart1.Chart); 
Line line = new Line(tChart1.Chart); 
line.FillSampleValues(); 

tool.Axis = tChart1.Axes.Left;

[VB.Net]

Dim tool As AxisScroll =  New AxisScroll(tChart1.Chart)  
Dim line As Line =  New Line(tChart1.Chart)  
line.FillSampleValues() 
  
tool.Axis = tChart1.Axes.Left