FlexChart for WinForms
ラインマーカー
要素 > ラインマーカー

ラインマーカーは、チャートプロット内の水平線または垂直線で、軸上の何らかの値に連結されます。ラインマーカーには正確なデータ値を表示するラベルが添付され、一般に、チャートの傾向を表示したり、重要な値や閾値をマーキングするために使用されます。ラインマーカーは、チャートに大量のデータポイントがプロットされている場合に便利です。また、グラフにプロットされた複数の系列の正確なデータ値を含むラベルを表示するためにも使用できます。たとえば、株式の毎日の価格変動を年間を通じてプロットするチャートでは、ラインマーカーはとても便利です。

ラインマーカーチャート

FlexChart は、C1.Win.Chart.Interaction 名前空間の LineMarker クラスを介してラインマーカーを提供します。このクラスの Lines プロパティを設定して、ラインマーカーの表示方法を水平線、垂直線、両方、またはなし(デフォルト)に指定できます。このプロパティは、LineMarkerLines 列挙に含まれる値を受け取ります。 LineMarker クラスは、ラインマーカーラベルのコンテンツをカスタマイズする Content プロパティと、データ値に対してラベルの位置を設定する Alignment プロパティも提供します。

FlexChart では、デフォルトでラインマーカーはポインタと一緒に移動し、エンドユーザーがポインタの位置にある正確なデータ値を把握できるようにします。ただし、この挙動は Interaction プロパティを None または Drag に設定することで変更できます。この値を None にすると、ラインマーカーは固定され、エンドユーザーがラインマーカーを操作することはできません。この値を Drag にすると、エンドユーザーはラインマーカーをプロット領域内の任意の位置にドラッグできます。 後者の場合、DragContent プロパティを設定することで、コンテンツをドラッグできるようにするかどうかを指定できます。同様に、DragLines プロパティは、垂直線と水平線のいずれかがドラッグされたときに、それらが互いにリンクするかどうかを定義します。さらに、FlexChart では、VerticalPosition および HorizontalPosition プロパティを使用して、チャートを最初に読み込んだときのラインマーカーのデフォルトの位置を指定することもできます。 これらのプロパティは、0 から 1 までの double 型の値を受け取ります。

C1.Win.Chart.Interaction.LineMarker lineMarker = new C1.Win.Chart.Interaction.LineMarker(this.flexChart1);

// 水平、垂直、または両方のラインマーカーを表示するかどうかを設定します
lineMarker.Lines = C1.Win.Chart.Interaction.LineMarkerLines.Both;

// マーカーのデフォルト位置を設定します
lineMarker.VerticalPosition = 0.2;
lineMarker.HorizontalPosition = 0.3;

// 断面に関連するラインマーカーの内容を表示する位置を設定します
lineMarker.Alignment = C1.Win.Chart.Interaction.LineMarkerAlignment.Right;

// ユーザーがドラッグしてラインマーカーを移動できるようにします
lineMarker.Interaction = C1.Win.Chart.Interaction.LineMarkerInteraction.Drag;

// ラインマーカーを更新します
lineMarker.DragContent = true;

// ドラッグしたときに2つのラインマーカーがリンクされるかどうかを設定します
lineMarker.DragLines = true;

// カスタム内容を設定します
lineMarker.Content = "Total revenue generated ${Revenue} by the sales of {Orders} units";
Dim lineMarker As New C1.Win.Chart.Interaction.LineMarker(Me.flexChart1)

' 水平、垂直、または両方のラインマーカーを表示するかどうかを設定します
lineMarker.Lines = C1.Win.Chart.Interaction.LineMarkerLines.Both

' マーカーのデフォルト位置を設定します
lineMarker.VerticalPosition = 0.2
lineMarker.HorizontalPosition = 0.3

' 断面に関連するラインマーカーの内容を表示する位置を設定します
lineMarker.Alignment = C1.Win.Chart.Interaction.LineMarkerAlignment.Right

' ユーザーがドラッグしてラインマーカーを移動できるようにします
lineMarker.Interaction = C1.Win.Chart.Interaction.LineMarkerInteraction.Drag

' ラインマーカーを更新します
lineMarker.DragContent = True

' ドラッグしたときに2つのラインマーカーがリンクされるかどうかを設定します
lineMarker.DragLines = True

' カスタム内容を設定します
lineMarker.Content = "Total revenue generated ${Revenue} by the sales of {Orders} units"
関連トピック