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 プロパティは、引き出し線の端に表示される矢印などの embellishments を制御します。

プロパティは、 CalloutLineColor 任意のオブジェクトに設定でき Color ます。 引き出し線の色を設定した場合は、の色と、で定義されている embellishment も自動的に設定され CalloutLineAnchorCapStyle CalloutStyle ます。

プロパティは、 CalloutLineWidth 引き出し線のピクセル幅を制御します。 このプロパティを使用すると、およびの embellishments もスケーリングされ CalloutLineAnchorCapStyle CalloutStyle ます。

スマートラベルの移動は、モーション関連のいくつかのプロパティを使用して制御できます。 これらは、方向、距離、およびデータポイントラベルをプロットエリアから移動できるかどうかのルールを定義します。 既定の移動ルールでは、通常、ほとんどの問題が解決されます。 は、データポイント MaxMovingDistance ラベルが重なり合う場合に移動できる最大距離をピクセル単位で指定する値を定義します。 プロパティは、データポイント MinMovingDistance ラベルが重なり合う場合に移動されるデータポイントからの最小距離をピクセル単位で指定する値を定義します。 データポイントラベルの位置を再設定する必要がある場合、ラベルは少なくとも指定されたピクセル数だけ移動します。

プロパティは、 IsOverlappedHidden 重複する問題を解決できない場合にラベルを非表示にするかどうかを示します。 IsOverlappedHiddenプロパティがであり、で true 指定された領域内にデータポイントを描画できない場合、データポイント MinMovingDistance ラベルは MaxMovingDistance MovingDirection 描画されません。

プロパティは、 MovingDirection データポイントラベルを移動できる方向を定義します。 このプロパティ LabelAlignmentStyles は、1つの値、または複数の値のビットごとの or を受け取り LabelAlignmentStyles ます。 既定値は、すべての値のビットごとの or で、 LabelAlignmentStyles データポイントの中心を除くすべての可能な方向での再配置を可能にします。

スマートラベルは、次の種類のグラフではサポートされていません。

• 横棒グラフ: 横棒グラフと100% 積み上げ横棒グラフ。

• 図形グラフ: 円グラフ、ドーナツグラフ、極座標グラフ、およびレーダーチャート。

• 範囲グラフ: 範囲、範囲列、範囲横棒グラフ。

• 積み上げ面グラフ: 積み上げ面グラフと100% 積み上げ面グラフ。

コンストラクター

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)