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

點擊下載DotNetBar for WinForms最新試用版

圖表系列

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

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

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

ActualScaleTypeY –獲取通過檢查實際系列數(shù)據(jù)值發(fā)現(xiàn)的實際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ù)每個單獨(dú)的條形圖范圍或整個系列范圍）。將此屬性設(shè)置為“ ByBar”將導(dǎo)致漸變畫筆定義根據(jù)要填充的條的長度填充條區(qū)域。如果設(shè)置為“ BySeries”，則將根據(jù)最大系列條形圖長度填充每個條形圖。

BarLabelPosition –獲取或設(shè)置條形系列標(biāo)簽的位置（默認(rèn)為Center）。條形標(biāo)簽的位置可以位于“居中”，“附近”，“近內(nèi)”，“遠(yuǎn)”或“遠(yuǎn)內(nèi)”。“附近”和“遠(yuǎn)方”選項將標(biāo)簽放置在條形圖的外部，其余項目在條形圖的區(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中定義的第三個Y參數(shù)），則此屬性告訴ChartControl如何解釋和使用該數(shù)據(jù)。

無 -被忽略。

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

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

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

 BubbleMinSize –獲取或設(shè)置最小系列氣泡大小（以像素為單位）。默認(rèn)值是4。

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

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

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

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

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

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

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

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

DisplayLine –顯示通過定義的序列點的直線。

DisplaySpline –顯示通過定義的序列點的樣條曲線。

DisplayPoints –顯示每個定義的序列點。

DisplayUnsorted –點顯示為未排序。

DisplayClosed –起點和終點已連接。

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

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

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

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

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

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

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 –獲取添加到圖表上時分配給該系列的默認(rèn)調(diào)色板顏色。

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

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

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

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

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

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

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

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

在下圖中，“ yearly”系列和“ Average”系列的GroupId設(shè)置為“ 0”（默認(rèn)值）。“投影”系列的GroupId設(shè)置為“ 1”。

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

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

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

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

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

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

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

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

–提供“中位數(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)為定義的序列點生成的標(biāo)簽和用戶定義的標(biāo)簽（DataLabels）組成。此屬性通知ChartControl要顯示的點類型（和/或標(biāo)簽）。屬性值是位字段值，因此可以“或”在一起以產(chǎn)生所需的標(biāo)簽。

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

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

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

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

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

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

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

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

PointLabelSkip –獲取或設(shè)置要跳過的標(biāo)簽間點的數(shù)量。換句話說，如果 PointLabelSkip值設(shè)置為“ 1”，則將跳過所有其他標(biāo)簽。如果將其設(shè)置為“ 2”，則每個顯示的標(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。可以在存在EmptyValues的位置通過ChartControl渲染 EmptyLines。空行僅在不丟失的相鄰SeriesPoints之間呈現(xiàn)。默認(rèn)為' false '。

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

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

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

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

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

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

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

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

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

RefreshSeries（）

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

IsConvexHullPoint（SeriesPoint sp）

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

IsHighLightPoint（SeriesPoint sp）

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