React 軸タイプ
Ignite UI for React カテゴリ チャートは、IgrCategoryXAxis および IgrNumericYAxis タイプを 1 つだけ使用します。同様に、Ignite UI for React ファイナンシャル チャートは、IgrTimeXAxis タイプと IgrNumericYAxis タイプを 1 つだけ使用します。ただし、Ignite UI for React データ チャートは複数の軸タイプをサポートしており、軸の位置を設定してチャートの任意の側に配置したり、軸交差プロパティを使用してチャートの内部に配置したりできます。このトピックでは、相互に互換性のある軸とシリーズ、および固有の軸に対するいくつかの特定のプロパティについて、それぞれについて説明します。
デカルト軸
デカルト軸を持つ IgrDataChart では 3 つのタイプの X 軸を使用して水平 (X 軸) および垂直 (X 軸) 方向にデータをプロットすることが可能です。
(IgrCategoryXAxis、IgrNumericXAxis、および IgrTimeXAxis) と 2 つのタイプの Y 軸 (IgrCategoryYAxis および IgrNumericYAxis)。
カテゴリ X 軸
IgrCategoryXAxis は、そのデータを一連のカテゴリ データ項目として扱います。文字列や数値など、ほぼすべてのタイプのデータを表示できます。この軸に数値をプロットする場合、この軸は離散軸であり、連続ではないことに注意してください。これは、各カテゴリ データ項目がその前のデータ項目から等距離に配置されることを意味します。また、項目は軸のデータ ソースに表示される順序でプロットされます。
IgrCategoryXAxis では、データをプロットするために IgrDataSource と Label を提供する必要があります。通常、次のタイプの系列をプロットするために IgrNumericYAxis と共に使用されます。
次の例は、上記のスタイル設定プロパティの使用法を示しています:
カテゴリ Y 軸
IgrCategoryYAxis は、上記の IgrCategoryXAxis と非常によく似た働きをしますが、水平ではなく垂直に配置されます。また、この軸では、データをプロットするために IgrDataSource と Label を提供する必要があります。IgrCategoryYAxis は通常 IgrNumericXAxis と組み合わせて次のタイプのシリーズをプロットするために使用されます。
次の例は、IgrCategoryYAxis タイプの使用法を示しています:
数値 X 軸
IgrNumericXAxis は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、X 軸に沿って水平に配置されます。IgrNumericXAxis ラベルの位置は、IgrNumericYAxis と組み合わせた場合にサポートされるさまざまな ScatterSeries (散布シリーズ) の XMemberPath プロパティに依存します。または、IgrCategoryXAxis と組み合わせた場合、これらのラベルは、IgrBarSeries、IgrStackedBarSeries、および IgrStacked100BarSeries の ValueMemberPath に対応して配置されます。
IgrNumericXAxis は、次のタイプのシリーズと互換性があります:
-
IgrBarSeries -
IgrBubbleSeries -
IgrHighDensityScatterSeries -
IgrScatterSeries -
IgrScatterLineSeries -
IgrScatterSplineSeries -
IgrScatterAreaSeries -
IgrScatterContourSeries -
IgrScatterPolylineSeries -
IgrScatterPolygonSeries -
IgrStackedBarSeries -
IgrStacked100BarSeries
次の例は、IgrNumericXAxis の使用法を示しています:
数値 Y 軸
IgrNumericYAxis は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、Y 軸に沿って垂直に配置されます。IgrNumericYAxis ラベルの位置は、IgrNumericXAxis と組み合わせた場合にサポートされるさまざまな ScatterSeries (散布シリーズ) の YMemberPath プロパティに依存します。または、IgrCategoryYAxis と組み合わせた場合、これらのラベルは、上記の表に記載されているカテゴリまたは積層シリーズの ValueMemberPath に対応して配置されます。財務シリーズのいずれかを使用している場合、Open/High/Low/Close のパスと使用しているシリーズ タイプに対応して配置されます。
IgrNumericYAxis は、次のタイプのシリーズと互換性があります:
次の例は、IgrNumericYAxis の使用法を示しています:
時間 X 軸
IgrTimeXAxis は、そのデータを、日付でソートされた一連のデータ項目として扱います。この軸タイプのラベルは日付であり、日付間隔に従ってフォーマットおよび配置できます。この軸の日付範囲は、DateTimeMemberPath を使用してマップされたデータ列の日付値によって決定されます。これは、IgrDataSource とともに、この軸タイプでデータをプロットするために必要です。
IgrTimeXAxis は、IgrFinancialChart コンポーネントの X 軸タイプです。
時間 X 軸のブレーク
IgrTimeXAxis には、Breaks (ブレーク) を使用してデータの間隔を除外するオプションがあります。その結果、ラベルとプロットされたデータは除外された間隔では表示されません。たとえば、勤務日/休業日、休日、週末などです。IgrTimeAxisBreak のインスタンスを軸の Breaks コレクションに追加し、一意の Start、End、および Interval を使用して構成できます。
時間 X 軸の書式設定
IgrTimeXAxis には、IgrTimeAxisLabelFormat オブジェクトのコレクションを表す LabelFormats プロパティがあります。コレクションに追加された各 IgrTimeAxisLabelFormat は、一意の Format (書式) と Range (範囲) を割り当てる役割を果たします。これは、データを年からミリ秒にドリルダウンし、チャートに表示される時間の範囲に応じてラベルを調整する場合に特に役立ちます。
IgrTimeAxisLabelFormat の Format プロパティは、特定の表示範囲に使用する形式を指定します。IgrTimeAxisLabelFormat の Range プロパティは、軸ラベルの形式が別の形式に切り替わる表示範囲を指定します。たとえば、範囲が 10 日と 5 時間に設定された 2 つの IgrTimeAxisLabelFormat 要素がある場合、軸の表示範囲が 10 日未満になるとすぐに、5 時間形式に切り替わります。
時間 X 軸の間隔
IgrTimeXAxis は、カテゴリ軸と数値軸の従来の Interval プロパティを IgrTimeAxisInterval 型の Intervals コレクションに置き換えます。コレクションに追加された各 IgrTimeAxisInterval は、一意の Interval、Range、および IntervalType を割り当てる役割を果たします。これは、データを年単位からミリ秒単位にドリルダウンして、チャートに表示される時間の範囲に応じてラベル間に一意の間隔を設ける場合に特に役立ちます。これらのプロパティの説明は次のとおりです。
Interval: 使用する間隔を指定します。IntervalTypeプロパティに関連付けられています。たとえば、IntervalTypeがDaysに設定されている場合、Intervalで指定される数値は日数になります。Range: 軸間隔が別の間隔に切り替わる可視範囲を指定します。たとえば、範囲が 10 日間および 5 時間に設定された 2 つの TimeAxisInterval がある場合、軸の表示範囲が 10 日間より短くなる際に 5 時間範囲の間隔に変更します。IntervalType:Intervalプロパティの時間単位を指定します。
極座標軸
極座標軸を持つ IgrDataChart により、チャートの中心から外側 (半径軸) およびチャートの中心の周り (角度軸) にデータをプロットできます。
カテゴリ角度軸
IgrCategoryAngleAxis は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、その順序での位置に従って円の端に沿って配置されます。この軸のタイプでは、数字、文字列などのほぼすべてのデータのタイプを表示できます。
IgrCategoryAngleAxis は通常、ラジアル シリーズをプロットするために IgrNumericRadiusAxis と共に使用されます。
次の例は、IgrCategoryAngleAxis タイプの使用法を示しています:
比例カテゴリ角度軸
IgrProportionalCategoryAngleAxis は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、シーケンス内の位置に応じて円の端に沿って配置されます。この軸の種類では、数字、文字列などのほぼすべてのデータのタイプを表示できます。
IgrProportionalCategoryAngleAxis は通常、IgrNumericRadiusAxis と一緒に使用され、円チャートをプロットします (例: ラジアル シリーズ)。
次の例は、IgrProportionalCategoryAngleAxis タイプの使用方法を示しています。
数字角度軸
IgrNumericAngleAxis は、そのデータを連続的に変化する数値データ項目として扱います。この軸領域のラベルは、円形プロットの中心から始まる半径線に沿って配置されます。IgrNumericAngleAxis のラベルの位置は、極座標シリーズ オブジェクトの RadiusMemberPath プロパティまたはラジアル シリーズ オブジェクトの ValueMemberPath プロパティを使用してマップされたデータ列の値によって異なります。
IgrNumericAngleAxis は、IgrCategoryAngleAxis と共に使用してラジアル シリーズをプロットするか、IgrNumericRadiusAxis と共に使用して極座標シリーズをプロットすることができます。
次の例は、IgrNumericAngleAxis タイプの使用法を示しています:
数字半径軸
IgrNumericRadiusAxis は、データを連続的に変化する数値データ項目として扱います。この軸のラベルは、円形プロットの周りに配置されます。ラベルの位置は、対応する極座標シリーズの AngleMemberPath プロパティを使用してマップされたデータ列の値によって異なります。
IgrNumericRadiusAxis を IgrNumericRadiusAxis と共に使用して、極座標シリーズをプロットできます。
次の例は、IgrNumericRadiusAxis タイプの使用法を示しています:
その他のリソース
関連するチャート機能の詳細については、次のトピックを参照してください: