图例设计
TChart Series类是所有Series类型的共同原型。当使用TeeChart在线帮助获取关于任何系列类型的帮助时,请遵循位于继承类型列表中的系列类的链接,然后单击系列成员,其中将包含所有继承属性和方法的列表。
加入官方社群740060302,欢迎相互交流
系列类结构
作为对TeeChart类型库结构的一点背景知识,这里是对Series类和接口的解释。下图显示了TeeChart系列类之间的关系。所有类都派生自泛型“Series”类,因此共享“Series”属性和方法。几个抽象类派生自系列(Custom3DSeries, CustomBarSeries和CircledSeries),这些是灰色突出显示的,它们的接口不能直接用于编程,它们的特征由它们的衍生系列类型继承。所有衍生系列(橙色)都可以在TeeChart画廊中访问,以便包含在您的图表中。以这种方式派生的TeeChart系列允许通过公共索引结构对继承的属性和方法进行可编程访问(请参阅本节后面的示例代码)。
使用TChart编辑器在设计时添加系列更容易,但您也可以在运行时为相同的TChart创建和添加新的和不同的系列类型。
所有AreaSeries属性和方法都可用于新系列,就像在设计时创建的任何系列一样。
在同一图表中混合不同系列类的一个例子是,在设计时使用TeeChart编辑器向图表添加区域(系列(0))、条形(系列(1))和线条(系列(2))系列。所有这些都访问一个共同的索引结构,即图表的系列列表。要使用该系列,可能如下所示:
[C#]
//Add a series at runtime private void button1_Click(object sender, System.EventArgs e) { Steema.TeeChart.Styles.Area tmpAreaSeries = new Steema.TeeChart.Styles.Area(tChart1.Chart); tmpAreaSeries.FillSampleValues(4); //Or //Steema.TeeChart.Styles.Area tmpAreaSeries = new Steema.TeeChart.Styles.Area(); //tChart1.Series.Add(tmpAreaSeries); //tmpAreaSeries.FillSampleValues(4); }
点击复制
[VB.Net]
'Add a series at runtime Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click Dim tmpAreaSeries As New Steema.TeeChart.Styles.Area(TChart1.Chart) tmpAreaSeries.FillSampleValues(4) 'Or 'Dim tmpAreaSeries As New Steema.TeeChart.Styles.Area() 'TChart1.Series.Add(tmpAreaSeries) 'tmpAreaSeries.FillSampleValues(4) End Sub
点击复制
选择串联类型
为图表选择系列类型在很大程度上取决于您自己对图表的要求。然而,在某些情况下,由于要绘制的变量的数量,图表的选择可能取决于哪些系列类型支持输入变量的数量。下表显示了每种系列类型允许的变量数量。
标记可用于扩展2变量系列类型的值。请参阅下面的示例,该示例在同一图表中使用了3个条形系列类型的实例。
例子:
使用Bar系列类型
以最简单的形式,数据产生以下图表,按月分组信息:
代码:
[C#]
foreach(Steema.TeeChart.Styles.Series tSeries in tChart1.Series) {tSeries.Marks.Visible = false;} tChart1.Header.Text = "Production results"; bar1.Add(300,"Jan"); bar1.Add(325,"Feb"); bar1.Add(287,"Mar"); bar1.Title = "Product10"; bar2.Add(175,"Jan"); bar2.Add(223,"Feb"); bar2.Add(241,"Mar"); bar2.Title = "Product12"; bar3.Add(461,"Jan"); bar3.Add(470,"Feb"); bar3.Add(455,"Mar"); bar3.Title = "Product14";
点击复制
[VB.Net]
Dim TSeries As Steema.TeeChart.Styles.Series For Each TSeries In TChart1.Series TSeries.Marks.Visible = False Next TChart1.Header.Text = "Production results" Bar1.Add(300, "Jan") Bar1.Add(325, "Feb") Bar1.Add(287, "Mar") Bar1.Title = "Product10" Bar2.Add(175, "Jan") Bar2.Add(223, "Feb") Bar2.Add(241, "Mar") Bar2.Title = "Product12" Bar3.Add(461, "Jan") Bar3.Add(470, "Feb") Bar3.Add(455, "Mar") Bar3.Title = "Product14"
点击复制
或者(按产品分组):
代码:
[C#]
foreach(Steema.TeeChart.Styles.Series tSeries in tChart1.Series)
foreach(Steema.TeeChart.Styles.Series tSeries in tChart1.Series) {tSeries.Marks.Visible = false;} tChart1.Header.Text = "Production results"; bar1.Add(300,"Product10"); bar1.Add(175,"Product12"); bar1.Add(461,"Product14"); bar1.Title = "Jan"; bar2.Add(325,"Product10"); bar2.Add(223,"Product12"); bar2.Add(470,"Product14"); bar2.Title = "Feb"; bar3.Add(287,"Product10"); bar3.Add(241,"Product12"); bar3.Add(455,"Product14"); bar3.Title = "Mar";
点击复制
[VB.Net]
Dim TSeries As Steema.TeeChart.Styles.Series For Each TSeries In TChart1.Series TSeries.Marks.Visible = False Next TChart1.Header.Text = "Production results" Bar1.Add(300, "Product10") Bar1.Add(175, "Product12") Bar1.Add(461, "Product14") Bar1.Title = "Jan" Bar2.Add(325, "Product10") Bar2.Add(223, "Product12") Bar2.Add(470, "Product14") Bar2.Title = "Feb" Bar3.Add(287, "Product10") Bar3.Add(241, "Product12") Bar3.Add(455, "Product14") Bar3.Title = "Mar"
点击复制
我们在上面的表中添加了新的值(stock):
表中的库存值通常高于月产量,因此显示它们会得到下图(这次是2D)。该图表使用线系列来区分股票。
将以下代码添加到前面示例的第一个代码中:
[C#]
line1.Add(600,"Jan"); line1.Add(715,"Feb"); line1.Add(676,"Mar"); line1.Title = "Product10 Stock"; line1.Color = bar1.Color; line2.Add(245,"Jan"); line2.Add(270,"Feb"); line2.Add(315,"Mar"); line2.Title = "Product10 Stock"; line2.Color = bar2.Color; line3.Add(800,"Jan"); line3.Add(755,"Feb"); line3.Add(835,"Mar"); line3.Title = "Product10 Stock"; line3.Color = bar3.Color;
点击复制
[VB.Net]
Line1.Add(600, "Jan") Line1.Add(715, "Feb") Line1.Add(676, "Mar") Line1.Title = "Product10 Stock" Line1.Color = Bar1.Color Line2.Add(245, "Jan") Line2.Add(270, "Feb") Line2.Add(315, "Mar") Line2.Title = "Product10 Stock" Line2.Color = Bar2.Color Line3.Add(800, "Jan") Line3.Add(755, "Feb") Line3.Add(835, "Mar") Line3.Title = "Product10 Stock" Line3.Color = Bar3.Color
点击复制
向系列添加数据
大多数系列类型(other than ADO.NET datasources Tutorial 8 and Functions Tutorial 7除外)使用Add方法的24个泛型重载来添加数据。
也有一些例外,见下表:
请注意,除了ShapeSeries之外,所有系列特定的Add方法都是作为进一步的重载自动添加到通用的Add方法中,因此可以从那里访问(例如candleSeries1)。添加(NewDateTime(27) 2002年,11日,100400200300);)。
添加点时,可以手动为点添加颜色
例子:
[C#]
bar1.Add(50,"Tomatoes",Color.Tomato);
点击复制
[VB.Net]
Bar1.Add(50, "Tomatoes", Color.Tomato)
点击复制
或者,您可以允许TeeChart分配颜色。TeeChart将为每个新系列或每个新系列点选择最多19种独特且尚未使用的颜色之一。ColorEach = True。
例子:
[C#]
Random rnd = new Random(); bar1.ColorEach = true; for(int i = 0; i < 19; ++i) { int higher = i + 65; char letter = (char) higher; bar1.Add(rnd.Next(100),letter.ToString()); }
点击复制
[VB.Net]
Dim i As Integer Bar1.ColorEach = True For i = 0 To 19 Bar1.Add(Rnd() * 100, Chr(i + 65)) Next
点击复制
可以在点上添加透明颜色,以便为ValueList中的值保留空间,而不显示在图表上。
例子:
[C#]
bar1.Add(45, "My Transparent Bar", Color.Transparent);
bar1.Add(45, "My Transparent Bar", Color.Transparent);
点击复制
[VB.Net]
Bar1.Add(45, "My Transparent Bar", Color.Transparent)
点击复制
从序列中删除数据点
Use Series.Delete to delete a point from a Series. Series.Delete有两个重载:
-
public Void Delete(System.Int32)
删除序列中的第n个点。 -
public Void Delete(System. Int32, System.Int32)
从序列中的第n个点开始删除若干点n。
例子:
[C#]
bar1.Delete(7,2); (deletes two points starting from the 8th Series point (index starts at zero))
点击复制
[VB.Net]
Bar1.Delete(7, 2) (deletes two points starting from the 8th Series point (index starts at zero))
点击复制
向序列添加空点
Series.Add 有三个重载,允许你添加一个Null点到一个系列:
-
添加一个新的空点。
public Int32 Add()
-
添加带有指定文本的新的空点。
public Int32 Add(System.String)
-
在具有指定文本的指定x值处添加新的空点
public Int32 Add(System.Double, System.String)
上面的第二个重载将向Series添加一个Null点,允许您为该点定义一个标签,但在该点的Series中留下一个断点。在Line Series的情况下,断点前的最后一个点不会与断点后的第一个点连接。
例子:
[C#]
line1.Add("Null Point");
line1.Add("Null Point");
点击复制
Line1.Add("Null Point")
点击复制
请在TeeChart帮助文件中查找其他两个重载的使用示例。
如需下载产品TeeChart for NET ,请点击产品名进入下载页面