LegendItem 类

定义

命名空间:

System.Web.UI.DataVisualization.Charting

程序集:

System.Web.DataVisualization.dll

表示一个图例项，它存储在 LegendItemsCollection 类中。

C#

public class LegendItem : System.Web.UI.DataVisualization.Charting.ChartNamedElement, System.Web.UI.DataVisualization.Charting.IChartMapArea

继承

Object

ChartElement

ChartNamedElement

LegendItem

实现

IChartMapArea

注解

类 LegendItem 表示图例项，可以是默认项或自定义项：

• 默认图例项会自动插入到数据系列或数据点的图例中。 饼图和圆环图的默认条目表示绘制的数据点，而所有其他图表类型的条目表示绘制的序列。 默认情况下，这些图例条目对符号颜色使用数据点或系列颜色，对图例项文本使用系列或数据点的名称。 可以使用 控件的 Chart 事件在运行时CustomizeLegend自定义或删除默认图例项。

• 自定义图例项具有用户定义的文本、符号颜色等。 与默认条目不同，它们不与绘制的数据连接。 可以使用 对象的 属性Legend在设计时或运行时CustomItems添加自定义图例项。

图例符号可以是矩形、线条或标记，具体取决于 ImageStyle 对象的属性设置 LegendItem 。

自定义图例项的文本由 Name 属性确定。

构造函数

LegendItem()	初始化 LegendItem 类的新实例。
LegendItem(String, Color, String)	使用指定的名称、颜色和图像路径初始化 LegendItem 类的新实例。

属性

BackGradientStyle	获取或设置图例项的背景渐变的方向。 还确定是否使用渐变。
BackHatchStyle	获取或设置图例项的阴影样式。
BackImageTransparentColor	获取或设置在绘制背景图像时，将替换为透明色的颜色。
BackSecondaryColor	获取或设置图例项的辅助颜色。
BorderColor	获取或设置图例项的边框颜色。
BorderDashStyle	获取或设置图例项的边框样式。
BorderWidth	获取或设置图例项的边框宽度。
Cells	获取图例项单元的集合。
Color	获取或设置图例项的颜色。
Enabled	获取或设置一个标志，该标志指示是否启用图例项。
Image	获取或设置将为图例项符号显示的图像。
ImageStyle	获取或设置图例项图像的显示样式。
Legend	获取或设置与此图例项关联的 Legend 对象。
MapAreaAttributes	获取或设置图例项的映射区特性。
MarkerBorderColor	获取或设置标记的边框颜色（如果使用）。
MarkerBorderWidth	获取或设置标记的边框宽度（如果使用）。 以像素度量。
MarkerColor	获取或设置标记的颜色（如果使用）。
MarkerImage	获取或设置一个标记图像。
MarkerImageTransparentColor	获取或设置在绘制标记图像时，将替换为透明色的颜色。
MarkerSize	获取或设置图例项标记的大小（如果使用）。
MarkerStyle	获取或设置图例项标记样式。 也用于启用或禁用标记的显示。
Name	获取或设置图例项的名称。
PostBackValue	获取或设置在发生 Click 事件时，可以处理的回发值。
SeparatorColor	获取或设置图例项分隔符的颜色。
SeparatorType	获取或设置图例项的分隔符样式。
SeriesName	获取或设置与默认图例项关联的 Series 的名称。
SeriesPointIndex	获取或设置与默认图例项关联的 DataPoint 对象的索引。
ShadowColor	获取或设置图例项的阴影颜色。
ShadowOffset	获取或设置图例项的阴影偏移量（以像素为单位）。
Tag	获取或设置与此图表元素关联的对象。 (继承自 ChartElement)
ToolTip	获取或设置图例项的工具提示。
Url	获取或设置图例项的目标 URL。

方法

Dispose()	释放由 ChartElement 占用的资源。 (继承自 ChartElement)
Dispose(Boolean)	释放 LegendItem 类使用的非托管资源，并可以选择释放托管资源。
Equals(Object)	确定指定的 Object 是否等同于当前的 ChartElement。 (继承自 ChartElement)
GetHashCode()	返回特定类型的哈希算法。 (继承自 ChartElement)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前 Object 的字符串。 (继承自 ChartElement)

适用于