【TeeChart .NET教程】（十八）：TeeChart工具集合（上）——其它工具

上一篇：【TeeChart .NET教程】（十七）设计时，运行时和授权要求

【下载TeeChart.Net最新版本】

其它工具

1 3D网格转置工具

3D网格移调工具交换X和Z坐标以将基于网格的系列旋转90度。

设计时：

使用Grid3D系列组合框选择要旋转的系列。

运行时：

在运行时添加3DGrid转置工具如下例所示：

[C#]

private void Form1_Load(object sender, System.EventArgs e)  
        Surface surface1 = new Surface(tChart1.Chart); 
        GridTranspose gridTranspose1 = new GridTranspose(tChart1.Chart); 
        gridTranspose1.Series = surface1; 
        surface1.FillSampleValues(20); 
 
 
private void button1_Click(object sender, System.EventArgs e)  
        ((GridTranspose)tChart1.Tools[0]).Transpose(); 

[VB.Net]

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 
        Dim Surface1 As New Steema.TeeChart.Styles.Surface(TChart1.Chart) 
        Dim GridTranspose1 As New Steema.TeeChart.Tools.GridTranspose(TChart1.Chart) 
        Surface1.FillSampleValues(20) 
        GridTranspose1.Series = Surface1 
End Sub 
 
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click 
        CType(TChart1.Tools(0), Steema.TeeChart.Tools.GridTranspose).Transpose() 
End Sub

2 注释工具

注释工具允许在图表。

设计时：

注释工具的文本及其所在的框都可以完全配置。“Options”选项卡允许您输入所需的文本并相应地选择对齐方式。“Position”选项卡允许您通过默认值或自定义值指定其位置，同时可以通过取消选中自动复选框并选择高度和宽度值，从“Size”选项卡中修改注释的大小。从“Callout”选项卡中，您可以在“图表”上定义特定点，从该点绘制连接线到注释并修改其方面。“Chart”选项卡配置文本框，允许您更改其颜色，框架，图案，斜角，大小，圆度和透明度。“Text”选项卡可以设置文本字体，颜色，轮廓和间距以及文本阴影的颜色和大小。

运行时：

在运行时添加注释工具如下例所示：

private void Form1_Load(object sender, System.EventArgs e)  
        Bar bar1 = new Bar(tChart1.Chart); 
        Steema.TeeChart.Tools.Annotation annotation1 = new Steema.TeeChart.Tools.Annotation(tChart1.Chart); 
        annotation1.Active = true; 
        annotation1.Position = AnnotationPositions.LeftTop; 
        annotation1.Text = "My Chart Text"; 
 
        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 Annotation1 As New Steema.TeeChart.Tools.Annotation(TChart1.Chart)  
        Annotation1.Active = True 
        Annotation1.Position = Steema.TeeChart.AnnotationPositions.LeftTop 
        Annotation1.Text = "My Chart Text" 
 
        Bar1.FillSampleValues(20) 
End Sub

3 页码工具

页码工具上显示文本页码工具显示包含所选页码编号系统的完全可配置的文本框。

页码工具的文本及其所在的框都可以完全配置。“Options”选项卡允许您输入所需的文本，并按默认值或自定义值指定其位置。“Format”选项卡配置文本框，允许您更改其颜色（颜色编辑器），框架（笔编辑器），图案（HatchBrush编辑器），圆度和透明度。“Text”选项卡可以设置文本字体（字体编辑器），填充（填充画笔编辑器）以及文本阴影的颜色（颜色编辑器）和图案（HatchBrush编辑器）。“Gradient”选项卡配置文本框渐变的属性，“Shadow”选项卡配置文本框阴影的属性，而“Bevels”选项卡配置文本框斜面的属性。

运行时：

在运行时添加页码工具如下例所示：

private void Form1_Load(object sender, System.EventArgs e)  
        Bar bar1 = new Bar(tChart1.Chart); 
        PageNumber pageNumber1 = new PageNumber(tChart1.Chart); 
 
        bar1.FillSampleValues(200); 
        tChart1.Page.MaxPointsPerPage = 10;     
 
 
private void button1_Click(object sender, System.EventArgs e)  
        tChart1.Page.Previous(); 
 
 
private void button2_Click(object sender, System.EventArgs e)  
        tChart1.Page.Next(); 
 
 
[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 PageNumber1 As New Steema.TeeChart.PageNumber(TChart1.Chart) 
 
        Bar1.FillSampleValues(200) 
        TChart1.Page.MaxPointsPerPage = 10 
End Sub 
 
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click 
        TChart1.Page.Previous() 
End Sub 
 
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click 
        TChart1.Page.Next() 
End Sub 

4 旋转工具

在图表上拖动鼠标时，“旋转工具”会更改图表的高程和旋转。

可以使用样式组合框配置旋转工具旋转（将图表调整为垂直轴），提升（围绕水平轴旋转图表）或一次执行两个操作，也可以选择用于旋转图表的鼠标按钮。

在运行时添加旋转工具如下例所示：

Line line1 = new Line(tChart1.Chart); 
Rotate rotate1 = new Rotate(tChart1.Chart); 
 
line1.FillSampleValues(20); 
rotate1.Button = MouseButtons.Right; 
rotate1.Style = RotateStyles.Elevation; 
 
[VB.Net] 
Dim Line1 As New Steema.TeeChart.Styles.Line(TChart1.Chart) 
Dim Rotate1 As New Steema.TeeChart.Rotate(TChart1.Chart) 
 
Line1.FillSampleValues(20) 
Rotate1.Button = MouseButtons.Right 
Rotate1.Style = Steema.TeeChart.RotateStyles.Elevation 

5 图例ScrollBar工具

图例滚动条工具允许通过鼠标拖动滚动轴。

图例滚动工具编辑器中的各种按钮使工具的不同方面能够以图形方式完全配置，而初始延迟设置单击工具和图表重绘之间的时间量。

运行时：

在运行时添加图例滚动工具如下例所示：

[C#]

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

[VB.Net]

Dim line As Line =  New Line(TChart1.Chart)  
Dim tool As LegendScrollBar =  New LegendScrollBar(TChart1.Chart)  
line.FillSampleValues()

6 2D照明工具

2D照明工具在图表画布上显示2维“浅色”效果。

设计时：

可以指定灯具的位置（左侧和顶部），也可以选择让工具跟随鼠标。

运行时：

在运行时添加2D照明工具如下例所示：

[C#]

Line line = new Line(tChart1.Chart); 
LightTool tool = new LightTool(tChart1.Chart); 
tool.FollowMouse = true; //slow in Debug build 
line.FillSampleValues();

[VB.Net]

Dim line As Line =  New Line(TChart1.Chart)  
Dim tool As LightTool =  New LightTool(TChart1.Chart)  
tool.FollowMouse = True 'slow in Debug build 
line.FillSampleValues()

7 SubChart工具

SubChart工具允许在单个图表中包含多个图表。

设计时：

子图表使用“Add ”按钮添加到图表中，并使用嵌套图表编辑器进行配置。

运行时：

在运行时添加SubChart工具如下例所示：

[C#]

Line line = new Line(tChart1.Chart); 
SubChartTool tool = new SubChartTool(tChart1.Chart); 
line.FillSampleValues(); 
TChart chart1 = tool.Charts.AddChart("Chart1"); 
chart1.Series.Add(typeof(Bar)); 
chart1[0].FillSampleValues();

[VB.Net]

Dim line As Line = New Line(TChart1.Chart) 
Dim tool As SubChartTool = New SubChartTool(TChart1.Chart) 
line.FillSampleValues() 
Dim chart1 As TChart = tool.Charts.AddChart("Chart1") 
chart1.Series.Add(GetType(Bar)) 
chart1(0).FillSampleValues()

8 渐变工具

渐变工具实现淡入或淡出图表动画。

设计时：

使用渐变工具编辑器设置动画的速度，“empty”颜色，样式和初始延迟。

运行时：

在运行时添加渐变工具如下例所示：

[C#]

private FaderTool tool; 
private void InitializeChart() 
 
     Line line = new Line(tChart1.Chart); 
     tool = new FaderTool(tChart1.Chart); 
     tool.Color = Color.Yellow; 
     line.FillSampleValues(); 
 
 
private void button1_Click(object sender, EventArgs e) 
 
     tool.Start();

[VB.Net]

Private tool As FaderTool 
Private  Sub InitializeChart() 
     Dim line As Line =  New Line(TChart1.Chart)  
     tool = New FaderTool(TChart1.Chart) 
     tool.Color = Color.Yellow 
     line.FillSampleValues() 
End Sub 
  
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click 
     tool.Start() 
End Sub

9 矩形工具

矩形工具是一个可以拖动和调整大小的注释工具。

设计时：

编辑器提供文本及其边界区域的完整配置。

运行时：

在运行时添加矩形工具如下例所示：

[C#]

Line line = new Line(tChart1.Chart); 
RectangleTool tool = new RectangleTool(tChart1.Chart); 
line.FillSampleValues(); 
tool.Text = "Text";

[VB.Net]

Dim line As Line =  New Line(TChart1.Chart)  
Dim tool As RectangleTool =  New RectangleTool(TChart1.Chart)  
line.FillSampleValues() 
tool.Text = "Text"

10 选择器工具

选择器工具使最终用户能够单击和拖动图表元素，如系列，轴，图例，标题等。

设计时：

选择器工具编辑器使您可以配置表示所选对象的句柄的大小和画笔特征，以及是否可以拖动可拖动对象（例如图例），还可以定义工具处于活动状态时显示的光标样式。

运行时：

在运行时添加选择工具如下例所示：

[C#]

Bar bar = new Bar(tChart1.Chart); 
Selector tool = new Selector(tChart1.Chart); 
bar.FillSampleValues(); 
tool.Cursor = Cursors.IBeam;

[VB.Net]

Dim bar As Bar =  New Bar(TChart1.Chart)  
Dim tool As Selector =  New Selector(TChart1.Chart)  
bar.FillSampleValues() 
tool.Cursor = Cursors.IBeam

11 转置系列工具

转置系列工具交换多个系列行和列。

设计时：

单击“Transpose”按钮执行操作。

运行时：

在运行时添加转置系列工具如下例所示：

[C#]

private SeriesTranspose tool; 
private void InitializeChart() 
 
     Bar bar = new Bar(tChart1.Chart); 
     bar.MultiBar = MultiBars.None; 
     tool = new SeriesTranspose(tChart1.Chart); 
     bar.FillSampleValues(); 
 
 
private void button1_Click(object sender, EventArgs e) 
 
     tool.Transpose();

[VB.Net]

Private tool As SeriesTranspose 
Private  Sub InitializeChart() 
     Dim bar As Bar =  New Bar(tChart1.Chart)  
     bar.MultiBar = MultiBars.None 
     tool = New SeriesTranspose(tChart1.Chart) 
     bar.FillSampleValues() 
End Sub 
  
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click 
     tool.Transpose() 
End Sub

12 数据表工具

除垂直轴或水平轴外，数据表工具还显示类似Excel的表。

设计时：

使用数据表编辑器配置表的边框（行和列），位置和文本格式。

运行时：

在运行时添加数据表工具如下例所示：

[C#]

Bar bar = new Bar(tChart1.Chart); 
DataTableTool tool = new DataTableTool(tChart1.Chart); 
bar.FillSampleValues();

[VB.Net]

Dim bar As Bar =  New Bar(TChart1.Chart)  
Dim tool As DataTableTool =  New DataTableTool(TChart1.Chart)  
bar.FillSampleValues()

13 横幅工具

横幅工具可生成滚动和闪烁的文本动画。

设计时：

使用横幅工具编辑器配置工具的文本和边界框。

运行时：

在运行时添加横幅工具如下例所示：

[C#]

Bar bar = new Bar(tChart1.Chart); 
BannerTool tool = new BannerTool(tChart1.Chart); 
bar.FillSampleValues(); 
tool.Text = "Text";

[VB.Net]

Dim bar As Bar =  New Bar(TChart1.Chart)  
Dim tool As BannerTool =  New BannerTool(TChart1.Chart)  
bar.FillSampleValues() 
tool.Text = "Text"

14 放大工具

放大工具放大图表的一部分。

设计时：

使用放大工具完全配置其图形和功能特性。

运行时：

在运行时添加放大工具如下例所示：

[C#]

Bar bar = new Bar(tChart1.Chart); 
Magnify tool = new Magnify(tChart1.Chart); 
bar.FillSampleValues();

[VB.Net]

Dim bar As Bar =  New Bar(TChart1.Chart)  
Dim tool As Magnify =  New Magnify(TChart1.Chart)  
bar.FillSampleValues()