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

---

【下載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()