DotNetBar for WinForms是一個(gè)擁有89個(gè)組件的用戶界面控件套包，用戶可以使用Visual Studio 2005-2015輕松地創(chuàng)建專業(yè)的用戶界面。十多年來DotNetBar幫助開發(fā)人員輕松地創(chuàng)建易用的專業(yè)Windows Forms (WinForms) 用戶界面。

點(diǎn)擊下載DotNetBar for WinForms最新試用版

圖表系列

ChartSeries對象是定義所有已定義圖表系列的屬性，數(shù)據(jù)和行為的對象。

以下是可用于所有ChartSeries元素的屬性的列表。

ActualScaleTypeX –獲取通過檢查實(shí)際系列數(shù)據(jù)值發(fā)現(xiàn)的X軸實(shí)際比例類型。ScaleType可以是 DateTime，Quantitative或Qualitative。

ActualScaleTypeY –獲取通過檢查實(shí)際系列數(shù)據(jù)值發(fā)現(xiàn)的實(shí)際Y軸比例類型。ScaleType可以是 DateTime，Quantitative或Qualitative。

AxisX –獲取與該系列關(guān)聯(lián)的X軸的引用。如果為 null，則該系列將自動與通過 chartXy.AxisX屬性定義的默認(rèn)主軸相關(guān)聯(lián)。如果非null，則必須將其設(shè)置為先前定義的 chartXy.AncillaryAxisX元素。

AxisY –獲取與該系列關(guān)聯(lián)的Y軸的引用。如果為 null，則該系列將自動與通過 chartXy.AxisY屬性定義的默認(rèn)主軸相關(guān)聯(lián)。如果為非null，則必須將其設(shè)置為先前定義的 chartXy.AncillaryAxisY元素。

BarFillRange –獲取或設(shè)置填充系列條形圖的方式（根據(jù)每個(gè)單獨(dú)的條形圖范圍或整個(gè)系列范圍）。將此屬性設(shè)置為“ ByBar”將導(dǎo)致漸變畫筆定義根據(jù)要填充的條的長度填充條區(qū)域。如果設(shè)置為“ BySeries”，則將根據(jù)最大系列條形圖長度填充每個(gè)條形圖。

BarLabelPosition ;–獲取或設(shè)置條形系列標(biāo)簽的位置（默認(rèn)為Center）。條形標(biāo)簽的位置可以位于“居中”，“附近”，“近內(nèi)”，“遠(yuǎn)”或“遠(yuǎn)內(nèi)”。“附近”和“遠(yuǎn)方”選項(xiàng)將標(biāo)簽放置在條形圖的外部，其余項(xiàng)目在條形圖的區(qū)域內(nèi)。如果外部條形標(biāo)簽不能這樣定位，則將其放置在條形內(nèi)部。

BarShadingEnabled –獲取或設(shè)置是否為水平和垂直條系列啟用條陰影。啟用后，圖表代碼將在條形圖上添加陰影。如果您要自己預(yù)先渲染鋼筋（并取消默認(rèn)操作），則不會添加任何陰影。

BarWidthRatio –獲取或設(shè)置鋼筋寬度與鋼筋組間距的比率（默認(rèn)為1 –鋼筋寬度與間距匹配）。

BubbleIntensityMode –獲取或設(shè)置用于確定系列氣泡強(qiáng)度的模式。如果為Bubble系列提供了強(qiáng)度數(shù)據(jù)（在其SeriesPoints中定義的第三個(gè)Y參數(shù)），則此屬性告訴ChartControl如何解釋和使用該數(shù)據(jù)。

無 -被忽略。

Alpha –聲明該值為絕對色度Alpha值，將應(yīng)用于分配的系列顏色。

值 –聲明該值為數(shù)據(jù)顏色Alpha值，將與該系列中所有其他定義的強(qiáng)度數(shù)據(jù)值一起使用），以計(jì)算要應(yīng)用于分配的系列顏色的相對Alpha值。

BubbleMaxPercentage –獲取或設(shè)置用于計(jì)算系列氣泡大小的顯示區(qū)域的最大百分比。ChartControl將采用較小的圖表寬度和高度，并將其與 BubbleMaxPercentage一起使用以計(jì)算圖表中允許的最大氣泡大小。默認(rèn)值為.25（或25％）。

BubbleMinSize –獲取或設(shè)置最小系列氣泡大?。ㄒ韵袼貫閱挝唬?默認(rèn)值是4。

 BubbleScaleFactor –獲取或設(shè)置用于計(jì)算系列氣泡大小的比例因子。默認(rèn)值為1。設(shè)置為2，將使氣泡大小加倍，將3變?yōu)槿叮?5將氣泡大小變?yōu)檎４笮〉囊话?，依此類推?

BubbleSizeMode –獲取或設(shè)置用于計(jì)算系列氣泡大小的模式。

面積 –氣泡大小與氣泡面積成正比。

直徑 –氣泡大小與氣泡直徑成正比。

ChartIndicators –獲取對圖表指標(biāo)集合的引用。ChartIndicators可以是趨勢線或 RegressionLines。每個(gè)系列可以具有任意數(shù)量的TrendLines –這只是一條連接任何2個(gè)定義的系列點(diǎn)的風(fēng)格化線。每個(gè)系列還可以顯示最小二乘回歸線。

ChartLegendItemVisualStyles –獲取或設(shè)置與系列關(guān)聯(lián)的圖例項(xiàng)目的視覺樣式。圖例項(xiàng)可以設(shè)置為 Default， MouseOver和 Selection樣式。

ChartLineAreaDisplayMode –獲取或設(shè)置行“ Area”顯示模式。當(dāng)ChartLineAreaDisplayMode設(shè)置了相應(yīng)的ChartLineDisplayMode時(shí)，也可以為一個(gè)系列呈現(xiàn)多行“區(qū)域” 。

ChartLineDisplayMode –獲取或設(shè)置 SeriesType.Line系列的顯示模式。的 ChartLineDisplayMode值是按位值，可以是“或-ED”根據(jù)需要一起。

DisplayLine –顯示通過定義的序列點(diǎn)的直線。

DisplaySpline –顯示通過定義的序列點(diǎn)的樣條曲線。

DisplayPoints –顯示每個(gè)定義的序列點(diǎn)。

DisplayUnsorted –點(diǎn)顯示為未排序。

DisplayClosed –起點(diǎn)和終點(diǎn)已連接。

ChartSeriesVisualStyle –獲取或設(shè)置系列的視覺樣式。

ConvexHullDisplayMode –獲取或設(shè)置ConvexHull顯示模式。甲凸形輪廓是最小的，封閉的，凸的多邊形即encompases和包括在所述系列中的所有點(diǎn)。ConvexHull既可以呈現(xiàn)為背景，也可以呈現(xiàn)為邊框，也可以呈現(xiàn)為兩者-具有自己的樣式。

CrosshairEnabled –獲取或設(shè)置是否為該系列啟用了Crosshair支持。

CrosshairHighlightPoints –獲取或設(shè)置是否為該系列啟用Crosshair Point高亮顯示。如果將此屬性設(shè)置為' true '，則當(dāng)圖表十字準(zhǔn)線與序列中的一個(gè)點(diǎn)相交時(shí)，該點(diǎn)將被“突出顯示 ”（與之關(guān)聯(lián)的 PointLabel / DataLabel也可以）。

CrosshairShowLabels –獲取或設(shè)置是否為該系列顯示Crosshair標(biāo)簽。十字準(zhǔn)線標(biāo)簽是標(biāo)注樣式標(biāo)簽，顯示與相交點(diǎn)有關(guān)的公共（或單個(gè)）數(shù)據(jù)。

DataLabels –獲取或設(shè)置用戶定義的實(shí)例數(shù)據(jù)標(biāo)簽的列表?？梢詾閳D表中的任何點(diǎn)創(chuàng)建實(shí)例數(shù)據(jù)標(biāo)簽（即使該點(diǎn)不包含在系列中）。它將顯示為普通的PointLabel（由“圖表控件”生成），并且可以完全配置為單個(gè)元素。

DataLabelVisualStyle –獲取或設(shè)置數(shù)據(jù)標(biāo)簽的視覺樣式。

DataPropertyNameSeries –從綁定的數(shù)據(jù)源獲取或設(shè)置數(shù)據(jù)字段的名稱，序列名稱綁定到該數(shù)據(jù)字段。

DataPropertyNameX –獲取或設(shè)置 X軸數(shù)據(jù)綁定到的數(shù)據(jù)字段的名稱。

DataPropertyNamesY –獲取或設(shè)置 Y軸數(shù)據(jù)綁定到的數(shù)據(jù)字段名稱的集合。

DataMember –獲取或設(shè)置系列綁定到的數(shù)據(jù)源中的列表或表的名稱。

DataSource –獲取或設(shè)置系列綁定到的數(shù)據(jù)源。

DefaultPaletteColor –獲取添加到圖表上時(shí)分配給該系列的默認(rèn)調(diào)色板顏色。

DisplayLinePointsOnTop –獲取或設(shè)置序列點(diǎn)是否顯示在序列線的頂部。

EffectiveDataLabelStyle –獲取對DataLabel有效（緩存，復(fù)合）樣式的引用。

不應(yīng)更改有效的樣式屬性，因?yàn)橹匦聞?chuàng)建復(fù)合樣式時(shí)，通過它們進(jìn)行的更改將丟失，這是其他樣式和程序更改所必需的。

EffectiveSeriesStyle –獲取對系列有效（緩存的，復(fù)合的）樣式的引用。

不應(yīng)更改有效的樣式屬性，因?yàn)橹匦聞?chuàng)建復(fù)合樣式時(shí)，通過它們進(jìn)行的更改將丟失，這是其他樣式和程序更改所必需的。

EmptyValues –獲取或設(shè)置用于確定序列點(diǎn)是否為空或缺失的值的集合。

EnableEmptyValues –獲取或設(shè)置是否在系列中處理 EmptyValues。默認(rèn)為' false '。

GroupId –獲取或設(shè)置用于對定性序列進(jìn)行分組的邏輯分組ID。每個(gè)系列都有一個(gè)與之關(guān)聯(lián)的 GroupId。此 GroupId可用于指示“圖表控件”如何將同一 GroupId的多個(gè)定性序列在同一邏輯“列”中“堆疊”在一起（請參閱 StackQualitativePoints）。

在下圖中，“ yearly”系列和“ Average”系列的GroupId設(shè)置為“ 0”（默認(rèn)值）?！巴队啊毕盗械腉roupId設(shè)置為“ 1”。

“每年”系列的StackQualitativePoints設(shè)置為“ true”，而“平均”系列的StackQualitativePoints設(shè)置為“ false”。對于“投影”系列，將StackQualitativePoints設(shè)置為什么都沒有關(guān)系，因?yàn)橥?組中沒有其他系列。

HiLoBarType –獲取或設(shè)置系列HiLoBar類型。HiLoBar類型可以是以下之一：

HiLoBarType Line指定僅使用行顯示HiLoBar（與Box和Candle顯示一樣，不存在Box）?！胺秶保ǜ?低）值由HiLo線的整個(gè)長度表示。“打開”值在刻度線的左側(cè)（垂直）或頂部（水平）上以刻度線/刻度線顯示。“ Close”值在刻度線的右側(cè)（垂直）或底部（水平時(shí)）以刻度線/刻度線顯示。提供（并顯示）“中位數(shù)”值時(shí)，它們表示為一條刻度線，該刻度線在中值處等距于范圍線。

HiLoBarType Box指定使用行（或晶須）和“打開/關(guān)閉”框的組合來顯示HiLoBar。晶須從顯示屏的頂部和底部（垂直顯示時(shí)）或左側(cè)和右側(cè)（水平顯示時(shí)）延伸。晶須表示高和低值，而方框表示打開和關(guān)閉值。

– 對于Box顯示，UseAlternateSegmentStyle默認(rèn)為“ False”。

–提供“中位數(shù)”值時(shí)，“框”顯示屏將用橫過顯示框的線標(biāo)記中位數(shù)。當(dāng)“關(guān)閉”值大于“打開”值時(shí)，框的上部（或整個(gè)區(qū)域，當(dāng)未指定中值時(shí)）用“默認(rèn)”背景填充，而下部（如果指定了中值） ）填充了備用背景。當(dāng)“打開”值大于“關(guān)閉”值時(shí)，將交換背景區(qū)域并用相反的背景值填充。

HiLoBarType Candle指定與HiLoBarType Box類型相同的高，低，開和關(guān)值。Candle和Box顯示之間有兩個(gè)主要區(qū)別，分別如下：

– 蠟燭顯示的UseAlternateSegmentStyle默認(rèn)為“ True”，而其他所有顯示（“行”和“框”）均默認(rèn)為“ False”。

–提供“中位數(shù)”值時(shí)，“蠟燭”顯示會用橫過顯示框的線標(biāo)記中值，與“框”顯示相同，但是，“框”背景的填充方式略有不同。框背景始終始終被默認(rèn)或備用框背景完全填充（取決于“打開”和“關(guān)閉”值之間的變化方向），并且背景相對于顯示的中間值沒有變化。

IsDisplayed –獲取序列是否顯示在圖表中（基于“可見性”和“圖例”檢查狀態(tài)）。

MaxValueX –獲取系列的最大X值。

MaxValueY –獲取系列的最大Y值。

MinValueX –獲取序列的最小X值。

MinValueY –獲取序列的最小Y值。

PointLabelDisplayMode –獲取或設(shè)置PointLabels / DataLabels系列的顯示模式。PointLabes由系統(tǒng)為定義的序列點(diǎn)生成的標(biāo)簽和用戶定義的標(biāo)簽（DataLabels）組成。此屬性通知ChartControl要顯示的點(diǎn)類型（和/或標(biāo)簽）。屬性值是位字段值，因此可以“或”在一起以產(chǎn)生所需的標(biāo)簽。

無 -將不顯示標(biāo)簽。

AllSeriesPoints –所有定義的系列點(diǎn)都將帶有標(biāo)簽。

DataLabels –將顯示用戶定義的DataLabels。

MinValueX –最小X值將顯示一個(gè)標(biāo)簽。

MinValueY –最小Y值將顯示一個(gè)標(biāo)簽。

MaxValueX –最大X值將顯示一個(gè)標(biāo)簽。

MaxValueY –最大Y值將顯示一個(gè)標(biāo)簽。

PointLabelMinDistance –獲取或設(shè)置標(biāo)簽數(shù)據(jù)點(diǎn)之間的最小距離。

PointLabelSkip –獲取或設(shè)置要跳過的標(biāo)簽間點(diǎn)的數(shù)量。換句話說，如果 PointLabelSkip值設(shè)置為“ 1”，則將跳過所有其他標(biāo)簽。如果將其設(shè)置為“ 2”，則每個(gè)顯示的標(biāo)簽都會跳過一些標(biāo)簽。

ScaleTypeX ;–獲取或設(shè)置X軸的Scale Type（可以是 DateTime，Quantitative或Qualitative）。

ScaleTypeY –獲取或設(shè)置Y軸的Scale Type（可以是 DateTime，Quantitative或Qualitative）。

SeriesPoints –獲取對 SeriesPoints集合的引用。（請參閱 SeriesPoints說明）。

SeriesType –獲取或設(shè)置系列類型。SeriesType可以是 Bubble，HorizontalDot，VerticalDot，Point，Line。SeriesSeriesType可以動態(tài)更改，但是，鑒于數(shù)據(jù)和/或軸定義，這樣做可能并不總是有意義。例如，為 HorizontalDot圖系列提供的數(shù)據(jù)對 Bubble系列圖幾乎沒有意義。默認(rèn)為' Point '。

ShowEmptyLines –獲取或設(shè)置在系列中是否顯示 EmptyLines?？梢栽诖嬖贓mptyValues的位置通過ChartControl渲染 EmptyLines?？招袃H在不丟失的相鄰SeriesPoints之間呈現(xiàn)。默認(rèn)為' false '。

ShowEmptyPoints –獲取或設(shè)置在系列中是否顯示 EmptyPoints。可以為遇到的每個(gè) EmptyValue呈現(xiàn) EmptyPoints。EmptyPoints位置是根據(jù)不丟失的相鄰SeriesPoints計(jì)算的。默認(rèn)為' false '。

ShowOriginValueLabels –獲取或設(shè)置是否為“ Origin”數(shù)據(jù)值顯示標(biāo)簽。

StackQualitativePoints –獲取或設(shè)置是在關(guān)聯(lián)的分組列中堆疊還是分散定性點(diǎn)。

 在接下來的兩幅圖像中，有6個(gè)定義的系列-5個(gè)“年度捐贈”系列（彩色條）和一個(gè)“平均捐贈”系列（綠色三角形）。“年度捐贈”系列與一個(gè)組相關(guān)聯(lián)（請參閱上面的GroupId），而“平均”系列與另一個(gè)組相關(guān)聯(lián)。

第一張圖片的StackQualitativePoints設(shè)置為' true '。
結(jié)果，所有具有相同GroupId的系列都“堆疊”在相同的定性“ 列 ”中。 

第二張圖片的StackQualitativePoints設(shè)置為' false '。
結(jié)果，所有系列均顯示在其自己的定性“ 列 ”中。

StepLines –獲取或設(shè)置顯示哪些“ Step lines”。此值可以是“ 無 ”，“ 水平 ”，“ 垂直 ”或“ 兩者 ”（或“ NotSet ”，默認(rèn)為“兩個(gè)”）。

StepLineMode –獲取或設(shè)置用于在定義的Line系列中渲染“ Step Lines”的模式（或渲染的Step Lines的順序）。設(shè)置值可以是“ 無 ”，“ HorizontalThenVertical ”，“ VerticalThenHorizontal ”或“ MidPoint ”（或“ NotSet”，默認(rèn)為“ HorizontalThenVertical ”）。

以下是所有ChartSeries元素可用的方法的列表。

RefreshSeries（）

導(dǎo)致系列刷新其顯示，因?yàn)榛A(chǔ)系列數(shù)據(jù)（可能）以某種方式發(fā)生了變化。

IsConvexHullPoint（SeriesPoint sp）

返回給定的SeriesPoint是否為ConvexHull點(diǎn)（即，包含為該系列計(jì)算的ConvexHull邊界的SeriesPoints之一）。

IsHighLightPoint（SeriesPoint sp）

確定給定的SeriesPoint是否為高光點(diǎn)（即Crosshair配置突出顯示的點(diǎn)）。