SmartLabelStyle 类

定义

命名空间:

System.Windows.Forms.DataVisualization.Charting

程序集:

System.Windows.Forms.DataVisualization.dll

提供用于执行基于规则的数据点标签智能定位的方法和属性，以解决数据点标签重叠的问题。

public ref class SmartLabelStyle

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class

Public Class SmartLabelStyle

继承

Object

SmartLabelStyle

派生

System.Windows.Forms.DataVisualization.Charting.AnnotationSmartLabelStyle

属性

TypeConverterAttribute

注解

启用智能标签后，图表会根据一组用户定义的规则重新定位重叠的数据点标签。

将绘制标注线以将标签与其数据点链接。 可以控制标注线的可视属性。 这些视觉属性包括颜色、线条样式和线条宽度。 CalloutStyle和 CalloutLineAnchorCapStyle 属性控制显示在标注线末尾的修饰（如箭头）。

属性 CalloutLineColor 可以设置为任何 Color 对象。 如果设置标注线的颜色，还会自动设置 定义的 和 修饰CalloutStyle的颜色CalloutLineAnchorCapStyle。

属性 CalloutLineWidth 控制标注线的像素宽度。 使用此属性还会缩放 和 CalloutStyle的CalloutLineAnchorCapStyle修饰。

可以通过使用多个运动相关属性来控制智能标签的移动。 这些规则定义了方向、距离以及是否允许数据点标签离开绘图区域的规则。 默认移动规则通常会解决大多数问题。 定义 MaxMovingDistance 一个值，该值指定在发生重叠时允许移动数据点标签的数据点的最大距离（以像素为单位）。 属性 MinMovingDistance 定义一个值，该值指定数据点标签在发生重叠时移动的数据点的最小距离（以像素为单位）。 当数据点标签需要重新定位时，标签将至少按指定的像素数移动。

属性 IsOverlappedHidden 指示当无法解决重叠问题时标签是否隐藏。 IsOverlappedHidden如果 属性为 true，并且无法在 指定的MinMovingDistance区域内和 MaxMovingDistance 允许的方向MovingDirection内绘制数据点，则不会绘制数据点标签。

属性 MovingDirection 定义可移动数据点标签 () 的方向。 此属性接受一个 LabelAlignmentStyles 值或多个 LabelAlignmentStyles 值的按位 OR。 默认值为所有值的按位 OR LabelAlignmentStyles ，以允许在除数据点中心外的所有可能方向上重新定位。

以下图表类型不支持智能标签：

• 条形图：条形图和百分之百堆积条形图。

• 形状图表：饼图、圆环图、极地图和雷达图。

• 范围图：范围、范围柱形图和范围条形图。

• 堆积面积图：堆积面积图和百分之百堆积面积图。

构造函数

SmartLabelStyle()

初始化 SmartLabelStyle 类的新实例。

属性

AllowOutsidePlotArea	获取或设置一个用于指定是否可以在绘图区之外绘制 SmartLabelStyle 对象的标志。
CalloutBackColor	获取或设置标签标注的背景色。
CalloutLineAnchorCapStyle	获取或设置标签标注线条的定位点端样式。
CalloutLineColor	获取或设置标签标注线条的颜色。
CalloutLineDashStyle	获取或设置标签标注线条的样式。
CalloutLineWidth	获取或设置标签标注线条的宽度。
CalloutStyle	获取或设置重新定位的 SmartLabelStyle 对象的标注样式。
Enabled	获取或设置指示 SmartLabelStyle 算法是否启用的标志。
IsMarkerOverlappingAllowed	获取或设置一个标志，该标志指定是否允许点标签与点标记重叠。
IsOverlappedHidden	获取或设置一个标志，该标志指示是否将隐藏无法重新定位的重叠标签。
MaxMovingDistance	获取或设置重叠的 SmartLabelStyle 对象可从标记移开的最大距离（以像素为单位）。
MinMovingDistance	获取或设置重叠的 SmartLabelStyle 对象可从标记移开的最小距离（以像素为单位）。
MovingDirection	获取或设置重叠的 SmartLabelStyle 对象可移动的方向。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)