SmartLabelStyle 类

定义

命名空间:

System.Web.UI.DataVisualization.Charting

程序集:

System.Web.DataVisualization.dll

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

public ref class SmartLabelStyle

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle

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

Public Class SmartLabelStyle

继承

Object

SmartLabelStyle

派生

System.Web.UI.DataVisualization.Charting.AnnotationSmartLabelStyle

属性

TypeConverterAttribute

示例

Imports System.Web.UI.DataVisualization.Charting  

Private Function SetSmartLabelsOptions()  

   ' Enabling the SmartLabels™ attribute.  
   Chart1.Series("Series1").SmartLabels.Enabled = true  

   ' Set the callout style.  
   Chart1.Series("Series1").SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined  

   ' Set the callout line color.  
   Chart1.Series("Series1").SmartLabels.CalloutLineColor = Color.Goldenrod;  

   ' Set the callout line style.  
   Chart1.Series("Series1").SmartLabels.CalloutLineStyle = ChartDashStyle.Dash  

   ' Set the callout line width.  
   Chart1.Series("Series1").SmartLabels.CalloutLineWidth = 3   

   ' Set the callout line anchor cap.  
   Chart1.Series("Series1").SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow  
End Function  

using System.Web.UI.DataVisualization.Charting  

private void SetSmartLabelsOptions()  
{  
   // Enabling the SmartLabels™ attribute.  
   Chart1.Series["Series1"].SmartLabels.Enabled = true;  

   // Set the callout style.  
   Chart1.Series["Series1"].SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined;  

   // Set the callout line color.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineColor = Color.Goldenrod;  

   // Set the callout line style.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineStyle = ChartDashStyle.Dash;  

   // Set the callout line width.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineWidth = 3;  

   // Set the callout line anchor cap.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow;  
}  

注解

启用智能标签后，图表将基于一组用户定义的规则重新定位重叠的分发点标签。

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

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

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

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

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

MovingDirection属性定义 () 移动数据点标签的方向。 此属性接受一 LabelAlignmentStyles 个值或多个值的位 LabelAlignmentStyles 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)