用户界面控件套包DotNetBar for WinForms入门教程（十）：图表系列

ChartSeries对象是定义所有已定义图表系列的属性，数据和行为的对象。以下是可用于所有ChartSeries元素的属性的列表。

DotNetBar for WinForms是一个拥有89个组件的用户界面控件套包，用户可以使用Visual Studio 2005-2015轻松地创建专业的用户界面。十多年来DotNetBar帮助开发人员轻松地创建易用的专业Windows Forms (WinForms) 用户界面。

DotNetBar for WinForms最新试用版

图表系列

ChartSeries对象是定义所有已定义图表系列的属性，数据和行为的对象。

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

ActualScaleTypeX –获取通过检查实际系列数据值发现的X轴实际比例类型。ScaleType可以是 DateTime，Quantitative或Qualitative。

ActualScaleTypeY –获取通过检查实际系列数据值发现的实际Y轴比例类型。ScaleType可以是 DateTime，Quantitative或Qualitative。

AxisX –获取与该系列关联的X轴的引用。如果为 null，则该系列将自动与通过 chartXy.AxisX属性定义的默认主轴相关联。如果非null，则必须将其设置为先前定义的 chartXy.AncillaryAxisX元素。

AxisY –获取与该系列关联的Y轴的引用。如果为 null，则该系列将自动与通过 chartXy.AxisY属性定义的默认主轴相关联。如果为非null，则必须将其设置为先前定义的 chartXy.AncillaryAxisY元素。

BarFillRange –获取或设置填充系列条形图的方式（根据每个单独的条形图范围或整个系列范围）。将此属性设置为“ ByBar”将导致渐变画笔定义根据要填充的条的长度填充条区域。如果设置为“ BySeries”，则将根据最大系列条形图长度填充每个条形图。

BarLabelPosition –获取或设置条形系列标签的位置（默认为Center）。条形标签的位置可以位于“居中”，“附近”，“近内”，“远”或“远内”。“附近”和“远方”选项将标签放置在条形图的外部，其余项目在条形图的区域内。如果外部条形标签不能这样定位，则将其放置在条形内部。

BarShadingEnabled –获取或设置是否为水平和垂直条系列启用条阴影。启用后，图表代码将在条形图上添加阴影。如果您要自己预先渲染钢筋（并取消默认操作），则不会添加任何阴影。

BarWidthRatio –获取或设置钢筋宽度与钢筋组间距的比率（默认为1 –钢筋宽度与间距匹配）。

BubbleIntensityMode –获取或设置用于确定系列气泡强度的模式。如果为Bubble系列提供了强度数据（在其SeriesPoints中定义的第三个Y参数），则此属性告诉ChartControl如何解释和使用该数据。

无 -被忽略。

Alpha –声明该值为绝对色度Alpha值，将应用于分配的系列颜色。

值 –声明该值为数据颜色Alpha值，将与该系列中所有其他定义的强度数据值一起使用），以计算要应用于分配的系列颜色的相对Alpha值。

BubbleMaxPercentage –获取或设置用于计算系列气泡大小的显示区域的最大百分比。ChartControl将采用较小的图表宽度和高度，并将其与 BubbleMaxPercentage一起使用以计算图表中允许的最大气泡大小。默认值为.25（或25％）。

BubbleMinSize –获取或设置最小系列气泡大小（以像素为单位）。默认值是4。

BubbleScaleFactor –获取或设置用于计算系列气泡大小的比例因子。默认值为1。设置为2，将使气泡大小加倍，将3变为三倍，.5将气泡大小变为正常大小的一半，依此类推。

BubbleSizeMode –获取或设置用于计算系列气泡大小的模式。

面积 –气泡大小与气泡面积成正比。

直径 –气泡大小与气泡直径成正比。

ChartIndicators –获取对图表指标集合的引用。ChartIndicators可以是趋势线或 RegressionLines。每个系列可以具有任意数量的TrendLines –这只是一条连接任何2个定义的系列点的风格化线。每个系列还可以显示最小二乘回归线。

ChartLegendItemVisualStyles –获取或设置与系列关联的图例项目的视觉样式。图例项可以设置为 Default， MouseOver和 Selection样式。

ChartLineAreaDisplayMode –获取或设置行“ Area”显示模式。当ChartLineAreaDisplayMode设置了相应的ChartLineDisplayMode时，也可以为一个系列呈现多行“区域” 。

ChartLineDisplayMode –获取或设置 SeriesType.Line系列的显示模式。的 ChartLineDisplayMode值是按位值，可以是“或-ED”根据需要一起。

DisplayLine –显示通过定义的序列点的直线。

DisplaySpline –显示通过定义的序列点的样条曲线。

DisplayPoints –显示每个定义的序列点。

DisplayUnsorted –点显示为未排序。

DisplayClosed –起点和终点已连接。

ChartSeriesVisualStyle –获取或设置系列的视觉样式。

ConvexHullDisplayMode –获取或设置ConvexHull显示模式。甲凸形轮廓是最小的，封闭的，凸的多边形即encompases和包括在所述系列中的所有点。ConvexHull既可以呈现为背景，也可以呈现为边框，也可以呈现为两者-具有自己的样式。

CrosshairEnabled –获取或设置是否为该系列启用了Crosshair支持。

CrosshairHighlightPoints –获取或设置是否为该系列启用Crosshair Point高亮显示。如果将此属性设置为’ true ‘，则当图表十字准线与序列中的一个点相交时，该点将被“突出显示 ”（与之关联的 PointLabel / DataLabel也可以）。

CrosshairShowLabels –获取或设置是否为该系列显示Crosshair标签。十字准线标签是标注样式标签，显示与相交点有关的公共（或单个）数据。

DataLabels –获取或设置用户定义的实例数据标签的列表。可以为图表中的任何点创建实例数据标签（即使该点不包含在系列中）。它将显示为普通的PointLabel（由“图表控件”生成），并且可以完全配置为单个元素。

DataLabelVisualStyle –获取或设置数据标签的视觉样式。

DataPropertyNameSeries –从绑定的数据源获取或设置数据字段的名称，序列名称绑定到该数据字段。

DataPropertyNameX –获取或设置 X轴数据绑定到的数据字段的名称。

DataPropertyNamesY –获取或设置 Y轴数据绑定到的数据字段名称的集合。

DataMember –获取或设置系列绑定到的数据源中的列表或表的名称。

DataSource –获取或设置系列绑定到的数据源。

DefaultPaletteColor –获取添加到图表上时分配给该系列的默认调色板颜色。

DisplayLinePointsOnTop –获取或设置序列点是否显示在序列线的顶部。

EffectiveDataLabelStyle –获取对DataLabel有效（缓存，复合）样式的引用。

不应更改有效的样式属性，因为重新创建复合样式时，通过它们进行的更改将丢失，这是其他样式和程序更改所必需的。

EffectiveSeriesStyle –获取对系列有效（缓存的，复合的）样式的引用。

不应更改有效的样式属性，因为重新创建复合样式时，通过它们进行的更改将丢失，这是其他样式和程序更改所必需的。

EmptyValues –获取或设置用于确定序列点是否为空或缺失的值的集合。

EnableEmptyValues –获取或设置是否在系列中处理 EmptyValues。默认为’ false ‘。

GroupId –获取或设置用于对定性序列进行分组的逻辑分组ID。每个系列都有一个与之关联的 GroupId。此 GroupId可用于指示“图表控件”如何将同一 GroupId的多个定性序列在同一逻辑“列”中“堆叠”在一起（请参阅 StackQualitativePoints）。

在下图中，“ yearly”系列和“ Average”系列的GroupId设置为“ 0”（默认值）。“投影”系列的GroupId设置为“ 1”。

“每年”系列的StackQualitativePoints设置为“ true”，而“平均”系列的StackQualitativePoints设置为“ false”。对于“投影”系列，将StackQualitativePoints设置为什么都没有关系，因为同一组中没有其他系列。

HiLoBarType –获取或设置系列HiLoBar类型。HiLoBar类型可以是以下之一：

HiLoBarType Line指定仅使用行显示HiLoBar（与Box和Candle显示一样，不存在Box）。“范围”（高/低）值由HiLo线的整个长度表示。“打开”值在刻度线的左侧（垂直）或顶部（水平）上以刻度线/刻度线显示。“ Close”值在刻度线的右侧（垂直）或底部（水平时）以刻度线/刻度线显示。提供（并显示）“中位数”值时，它们表示为一条刻度线，该刻度线在中值处等距于范围线。

HiLoBarType Box指定使用行（或晶须）和“打开/关闭”框的组合来显示HiLoBar。晶须从显示屏的顶部和底部（垂直显示时）或左侧和右侧（水平显示时）延伸。晶须表示高和低值，而方框表示打开和关闭值。

– 对于Box显示，UseAlternateSegmentStyle默认为“ False”。

–提供“中位数”值时，“框”显示屏将用横过显示框的线标记中位数。当“关闭”值大于“打开”值时，框的上部（或整个区域，当未指定中值时）用“默认”背景填充，而下部（如果指定了中值） ）填充了备用背景。当“打开”值大于“关闭”值时，将交换背景区域并用相反的背景值填充。

HiLoBarType Candle指定与HiLoBarType Box类型相同的高，低，开和关值。Candle和Box显示之间有两个主要区别，分别如下：

– 蜡烛显示的UseAlternateSegmentStyle默认为“ True”，而其他所有显示（“行”和“框”）均默认为“ False”。

–提供“中位数”值时，“蜡烛”显示会用横过显示框的线标记中值，与“框”显示相同，但是，“框”背景的填充方式略有不同。框背景始终始终被默认或备用框背景完全填充（取决于“打开”和“关闭”值之间的变化方向），并且背景相对于显示的中间值没有变化。

IsDisplayed –获取序列是否显示在图表中（基于“可见性”和“图例”检查状态）。

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

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

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

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

PointLabelDisplayMode –获取或设置PointLabels / DataLabels系列的显示模式。PointLabes由系统为定义的序列点生成的标签和用户定义的标签（DataLabels）组成。此属性通知ChartControl要显示的点类型（和/或标签）。属性值是位字段值，因此可以“或”在一起以产生所需的标签。

无 -将不显示标签。

AllSeriesPoints –所有定义的系列点都将带有标签。

DataLabels –将显示用户定义的DataLabels。

MinValueX –最小X值将显示一个标签。

MinValueY –最小Y值将显示一个标签。

MaxValueX –最大X值将显示一个标签。

MaxValueY –最大Y值将显示一个标签。

PointLabelMinDistance –获取或设置标签数据点之间的最小距离。

PointLabelSkip –获取或设置要跳过的标签间点的数量。换句话说，如果 PointLabelSkip值设置为“ 1”，则将跳过所有其他标签。如果将其设置为“ 2”，则每个显示的标签都会跳过一些标签。

ScaleTypeX –获取或设置X轴的Scale Type（可以是 DateTime，Quantitative或Qualitative）。

ScaleTypeY –获取或设置Y轴的Scale Type（可以是 DateTime，Quantitative或Qualitative）。

SeriesPoints –获取对 SeriesPoints集合的引用。（请参阅 SeriesPoints说明）。

SeriesType –获取或设置系列类型。SeriesType可以是 Bubble，HorizontalDot，VerticalDot，Point，Line。SeriesSeriesType可以动态更改，但是，鉴于数据和/或轴定义，这样做可能并不总是有意义。例如，为 HorizontalDot图系列提供的数据对 Bubble系列图几乎没有意义。默认为’ Point ‘。

ShowEmptyLines –获取或设置在系列中是否显示 EmptyLines。可以在存在EmptyValues的位置通过ChartControl渲染 EmptyLines。空行仅在不丢失的相邻SeriesPoints之间呈现。默认为’ false ‘。

ShowEmptyPoints –获取或设置在系列中是否显示 EmptyPoints。可以为遇到的每个 EmptyValue呈现 EmptyPoints。EmptyPoints位置是根据不丢失的相邻SeriesPoints计算的。默认为’ false ‘。

ShowOriginValueLabels –获取或设置是否为“ Origin”数据值显示标签。

StackQualitativePoints –获取或设置是在关联的分组列中堆叠还是分散定性点。

在接下来的两幅图像中，有6个定义的系列-5个“年度捐赠”系列（彩色条）和一个“平均捐赠”系列（绿色三角形）。“年度捐赠”系列与一个组相关联（请参阅上面的GroupId），而“平均”系列与另一个组相关联。

第一张图片的StackQualitativePoints设置为’ true ‘。
结果，所有具有相同GroupId的系列都“堆叠”在相同的定性“ 列 ”中。

第二张图片的StackQualitativePoints设置为’ false ‘。
结果，所有系列均显示在其自己的定性“ 列 ”中。

StepLines –获取或设置显示哪些“ Step lines”。此值可以是“ 无 ”，“ 水平 ”，“ 垂直 ”或“ 两者 ”（或“ NotSet ”，默认为“两个”）。

StepLineMode –获取或设置用于在定义的Line系列中渲染“ Step Lines”的模式（或渲染的Step Lines的顺序）。设置值可以是“ 无 ”，“ HorizontalThenVertical ”，“ VerticalThenHorizontal ”或“ MidPoint ”（或“ NotSet”，默认为“ HorizontalThenVertical ”）。

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

RefreshSeries（）

导致系列刷新其显示，因为基础系列数据（可能）以某种方式发生了变化。

IsConvexHullPoint（SeriesPoint sp）

返回给定的SeriesPoint是否为ConvexHull点（即，包含为该系列计算的ConvexHull边界的SeriesPoints之一）。

IsHighLightPoint（SeriesPoint sp）

确定给定的SeriesPoint是否为高光点（即Crosshair配置突出显示的点）。

想要获得DotNetBar for WinForms更多资源、正版授权的伙伴，请咨询【客服】了解
标签：

来源：慧都