バージョン

主間隔と副間隔の構成

トピックの概要

目的

このトピックではコード例を使用して、 UltraDataChart コントロールのチャート軸に主目盛と副目盛を構成する方法を説明します。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック 目的

UltraDataChart コントロールは、データ セットおよびデータ バインディングが必要です。このトピックでは、簡単なデータ オブジェクト モデルを提供する方法を示します。

このトピックは、 UltraDataChart コントロールによってサポートされる軸のタイプを紹介します。

軸に副間隔を構成

機能概要

UltraDataChart コントロールで、軸の主間隔は主グリッド線および軸ラベルがどれくらいの頻度で軸に描画されるかを指定します。同様に、軸副間隔は副グリッド線が軸に描画される頻度を指定します。

主間隔および副間隔はすべての数値およびカテゴリでサポートされます:

以下は、緑の線で主間隔に値 10 を使用した NumericYAxis 上の主間隔の画像です。NumericYAxis の副間隔には赤い線と値に 2.5 を使用しています。

DataChart Configuring Major and Minor Intervals 1.png

軸の主間隔および副間隔の実装は、軸で Interval および MinorInterval プロパティの値を 0 より大きくする必要があります。副間隔に対する副グリッド線を表示するには、軸の MinorStroke および MinorStrokeThickness プロパティを設定する必要があります。副グリッド線はデフォルトの色または太さが設定されていないため、表示するにはそれらをあらかじめ設定する必要があります。

デザイン情報

以下の表は、副間隔に使用するエフェクトの取得に必要となるプロパティ変更のマッピングを示します。

構成の目的: 使用するプロパティ 設定の選択肢:

主間隔グリッド線の頻度。

この値は軸ラベルおよび主間隔グリッド線に適切なスペース (使用される場合) を提供します。軸ラベルの間隔はこの値にも設定されます。間隔に関連付けられる軸ポイントに 1 ラベル表示されます。

この値は、カテゴリ軸で最初の項目から最後のカテゴリ項目までのインデックスとして表示されます。通常この値は、すべての軸ラベルが軸にフィットし、他の軸ラベルにクリップされないために、カテゴリ総数の 10-20% に相当します。

数値軸でこの値は軸の最小値から最大値までの double として表示されます。デフォルトで数値軸は軸の最小値および最高値に基づいて自動的に適切な間隔を計算します。

Date Time 軸でこの値は軸の最小値から最大値までの期間として表示されます。

主間隔グリッド線の色

軸主間隔の色。

主間隔グリッド線の太さ

double 値で設定された軸主目盛のピクセルでの太さ。

主間隔グリッド線の破線

ダッシュ配列内のダッシュの長さを記述するパラメータとして double[] を受け取る DoubleCollection

副間隔グリッド線の頻度

この値は、常に主間隔軸の間に描画される副グリッド線に適切なスペースを提供します。結果として、 MinorInterval プロパティの値は主 Interval プロパティの値より小さい値でなければなりません。

カテゴリ軸で、この値は主 Interval プロパティの小数として表示されます。通常、この値は 0.25 から 0.5 の間です。

数値軸でこの値は軸の最小値から最大値までの double として表示されます。デフォルトで数値軸は軸の最小値および最高値に基づいて自動的に適切な間隔を計算しません。

Date Time 軸でこの値は軸の最小値から最大値までの期間として表示されます。

副間隔グリッド線の色

軸副間隔の色。

副間隔グリッド線の太さ

double 値で設定された軸副目盛のピクセルでの太さ。

A dashed line for the minor interval gridlines

A DoubleCollection taking a double[] as its parameter to describe the length of the dashes in the dash array.

パフォーマンスへの影響

チャート コントロールで軸の主間隔と副間隔に以下のようなパフォーマンスに対する影響があります。

Interval プロパティに非常に小さい値 (軸範囲と比較) を設定することによって、チャートが多くの主グリッド線を描画します。これによってユーザーがズームやパン操作でチャートとインタラクション時、あるいは軸範囲によってパフォーマンスが低下する場合があります。このプロパティは設定せずに、チャートで自動的に適切な主間隔を計算することをお勧めします。主 Interval プロパティを設定することにより、主プロパティの値以下の軸範囲にユーザーがズームした場合に、軸ラベルと主グリッド線を描画しません。ただし、プロパティが未設定、あるいはユーザーがこのプロパティの値より軸範囲が小さくなるようズームする場合、チャートは自動的に主 Interval プロパティを再計算します。

MinorInterval プロパティに小さい値を設定するとチャートに多くの副グリッド線が描画されるため、主 Interval プロパティを設定するよりもパフォーマンスが低下します。これはチャートにズームやパン操作を行うユーザーに認識される場合があります。

NumericYAxis を使用した例

以下のスクリーンショットは、以下の間隔に関する設定で UltraDataChart コントロールの NumericYAxis の外観を示します。

プロパティ

MinorInterval

2.5

MinorStroke

Red

MinorStrokeThickness

1

Interval

10

MajorStroke

Green

MajorStrokeThickness

2

DataChart Configuring Major and Minor Intervals 1.png

C# の場合:

var yAxis = new NumericYAxis();
yAxis.MinorInterval = 2.5;
yAxis.MinorStrokeThickness = 1;
yAxis.MinorStroke = new SolidColorBrush(Color.Red);
yAxis.Interval = 10;
yAxis.MajorStrokeThickness = 2;
yAxis.MajorStroke = new SolidColorBrush(Color.Green);

Visual Basic の場合:

Dim yAxis = New NumericYAxis()
yAxis.MinorInterval = 2.5
yAxis.MinorStrokeThickness = 1
yAxis.MinorStroke = New SolidColorBrush(Color.Red)
yAxis.Interval = 10
yAxis.MajorStrokeThickness = 1
yAxis.MajorStroke = New SolidColorBrush(Color.Green)

以下のスクリーンショットは、以下の間隔に関する設定で UltraDataChart コントロールの NumericYAxis の外観を示します。

プロパティ

MinorInterval

0.5

MinorStroke

Red

MinorStrokeThickness

1

Interval

2

MajorStroke

Green

MajorStrokeThickness

2

DataChart Configuring Major and Minor Intervals 2.png

C# の場合:

var xAxis = new NumericXAxis();
xAxis.MinorInterval = 2.5;
xAxis.MinorStrokeThickness = 1;
xAxis.MinorStroke = new SolidColorBrush("Red");
xAxis.Interval = 10;
xAxis.MajorStrokeThickness = 2;
xAxis.MajorStroke = new SolidColorBrush("Green");

Visual Basic の場合:

Dim xAxis = New NumericXAxis()
xAxis.MinorInterval = 2.5
xAxis.MinorStrokeThickness = 1
xAxis.MinorStroke = New SolidColorBrush(Red)
xAxis.Interval = 10
xAxis.MajorStrokeThickness = 2
xAxis.MajorStroke = New SolidColorBrush(Green)

CategoryXAxis を使用した例

以下のスクリーンショットは、以下の間隔に関する設定の結果として、 UltraDataChart コントロールの CategoryXAxis の外観を示します。

プロパティ

MinorInterval

0.5

MinorStroke

Red

MinorStrokeThickness

1

Interval

2

MajorStroke

Green

MajorStrokeThickness

2

CategoryXAxis.Gap

0.5

DataChart Configuring Major and Minor Intervals 3.png

C# の場合:

var xAxis= new CategoryXAxis();
xAxis.MinorInterval = 2.5;
xAxis.MinorStrokeThickness = 1;
xAxis.MinorStroke = new SolidColorBrush("Red");
xAxis.Interval = 10;
xAxis.MajorStrokeThickness = 2;
xAxis.MajorStroke = new SolidColorBrush("Green");

Visual Basic の場合:

Dim xAxis = New CategoryXAxis()
xAxis.MinorInterval = 2.5
xAxisAxis.MinorStrokeThickness = 1
xAxis.MinorStroke = New SolidColorBrush(Red)
xAxis.Interval = 10
xAxis.MajorStrokeThickness = 2
xAxis.MajorStroke = New SolidColorBrush(Green)

CategoryDateTimeXAxis を使用した例

以下のスクリーンショットは、以下の間隔関連を設定した結果の UltraDataChart コントロールの CategoryDateTimeXAxis の外観を示します。

プロパティ

MinorInterval

2.5

MinorStroke

Red

MinorStrokeThickness

1

Interval

10

MajorStroke

Green

MajorStrokeThickness

2

DataChart Configuring Major and Minor Intervals 4.png

C# の場合:

var xAxis = new CategoryDateTimeXAxis();
xAxis.MinorInterval = new TimeSpan(0, 12, 0, 0);
xAxis.MinorStrokeThickness = 1;
xAxis.MinorStroke = new SolidColorBrush("Red");
xAxis.Interval = new TimeSpan(2, 0, 0, 0);
xAxis.MajorStrokeThickness = 3;
xAxis.MajorStroke = new SolidColorBrush("Green");

Visual Basic の場合:

Dim xAxis = New CategoryDateTimeXAxis()
xAxis.MinorInterval = New TimeSpan(0, 12, 0, 0)
xAxis.MinorStrokeThickness = 1
xAxis.MinorStroke = New SolidColorBrush(Red)
xAxis.Interval = New TimeSpan(2, 0, 0, 0)
xAxis.MajorStrokeThickness = 3
xAxis.MajorStroke = New SolidColorBrush(Green)

関連コンテンツ

トピック

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

UltraDataChart コントロールは、データ セットおよびデータ バインディングが必要です。このトピックでは、簡単なデータ オブジェクト モデルを提供する方法を示します。

このトピックは、 UltraDataChart コントロールによってサポートされる軸のタイプを紹介します。

このトピックは、コード例を示して、柱状シリーズを UltraDataChart コントロールで使用する方法を説明します。

このトピックは、コード例を示して、散布シリーズ タイプを UltraDataChart コントロールで使用する方法を説明します。