このトピックでは、ValueLayer シリーズ タイプについて説明します。ValueLayer のプロパティについて説明し、実装例を提供します。
本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。
ValueLayer は、XamDataChart に追加できるシリーズ タイプです。このシリーズ タイプの目的は、最小値、最大値、平均値などのデータのさまざまな焦点に、それらの計算されたポイントに破線を描画することによって注釈を付けることです。
注釈を付ける焦点を決定するには、ValueLayer の ValueMode プロパティを設定します。このプロパティは、以下に説明する ValueLayerValueMode 列挙のいずれかを受け取ります。
Auto: ValueLayerValueMode 列挙体のデフォルト値モード。
Average: 複数の値の線を適用して、チャートにプロットされた各系列の平均値を呼び出します。
GlobalAverage: 単一の値線を適用して、チャート内のすべての系列値の平均を呼び出します。
GlobalMaximum: 単一の値線を適用して、チャート内のすべての系列値の絶対最大値を呼び出します。
GlobalMinimum: 単一の値線を適用して、チャート内のすべての系列値の絶対最小値を呼び出します。
Maximum: チャートにプロットされた各系列の最大値を示すために、複数の値線を適用する可能性があります。
Minimum: チャートにプロットされた各系列の最小値を示すために、複数の値線を適用する可能性があります。
複数のレイヤーを異なる設定で使用する場合は、ValueLayer を設定して特定のシリーズをターゲットにできます。これを行うには、レイヤーに TargetSeries プロパティを設定します。
次の画像は、ValueLayer が追加され、Maximum ValueMode が適用された XamDataChart コントロールのプレビューです。
以下のコードは上記の例を実装します。
XAML の場合:
<ig:XamDataChart x:Name="chart">
<ig:XamDataChart.Axes>
<ig:CategoryXAxis x:Name="xAxis" ItemsSource="{Binding Data}" Label="{}{Label}" />
<ig:NumericYAxis x:Name="yAxis" />
</ig:XamDataChart.Axes>
<ig:XamDataChart.Series>
<ig:ColumnSeries XAxis="{Binding ElementName=xAxis}"
YAxis="{Binding ElementName=yAxis}"
ItemsSource="{Binding Data}"
ValueMemberPath="temperatureHigh" />
<ig:ColumnSeries XAxis="{Binding ElementName=xAxis}"
YAxis="{Binding ElementName=yAxis}"
ItemsSource="{Binding Data}"
ValueMemberPath="temperatureLow" />
<ig:ValueLayer ValueMode="Maximum" IsAxisAnnotationEnabled="True"/>
</ig:XamDataChart.Series>
</ig:XamDataChart>C# の場合:
var layer = new ValueLayer();
layer.IsAxisAnnotationEnabled = true;
layer.ValueMode = ValueLayerValueMode.Maximum;
DataChart.Series.Add(layer);