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