Class Axis
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
チャートの軸を表すオブジェクトをカプセル化します。
public class Axis
継承
継承されたメンバー
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
例
以下のコードから、Axisの単位、最大値、最小値を設定する方法を学ぶことができます。
//Workbookオブジェクトをインスタンス化
Workbook workbook = new Workbook();
//Excelオブジェクトに新しいワークシートを追加
int sheetIndex = workbook.Worksheets.Add();
//シートインデックスを渡して新しく追加されたワークシートの参照を取得
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//" A1" セルにサンプル値を追加
worksheet.Cells["A1"].PutValue(50);
//" A2" セルにサンプル値を追加
worksheet.Cells["A2"].PutValue(100);
//" A3" セルにサンプル値を追加
worksheet.Cells["A3"].PutValue(150);
//" B1" セルにサンプル値を追加
worksheet.Cells["B1"].PutValue(4);
//" B2" セルにサンプル値を追加
worksheet.Cells["B2"].PutValue(20);
//" B3" セルにサンプル値を追加
worksheet.Cells["B3"].PutValue(50);
//ワークシートにチャートを追加
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//新しく追加されたチャートのインスタンスにアクセス
Chart chart = worksheet.Charts[chartIndex];
//" A1" セルから" B3" までの範囲のNSeries(チャートデータソース)をチャートに追加
chart.NSeries.Add("A1:B3", true);
//値軸の最大値を設定
chart.ValueAxis.MaxValue = 200;
//値軸の最小値を設定
chart.ValueAxis.MinValue = 0;
//主要単位を設定
chart.ValueAxis.MajorUnit = 25;
//カテゴリ(X)軸が最大値で交差します。
chart.ValueAxis.CrossType = CrossType.Maximum;
//ティックマークラベルの間のカテゴリまたはシリーズの数を設定します。
chart.CategoryAxis.TickLabelSpacing = 2;
//ビジネスを行う
//Excelファイルを保存
workbook.Save("book1.xlsx");
'Workbookオブジェクトをインスタンス化
Dim workbook As Workbook = New Workbook()
'Excelオブジェクトに新しいワークシートを追加
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'シートインデックスを渡して新しく追加されたワークシートの参照を取得
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'" A1" セルにサンプル値を追加
worksheet.Cells("A1").PutValue(50)
' " A2" セルにサンプル値を追加
worksheet.Cells("A2").PutValue(100)
' " A3" セルにサンプル値を追加
worksheet.Cells("A3").PutValue(150)
' " B1" セルにサンプル値を追加
worksheet.Cells("B1").PutValue(4)
' " B2" セルにサンプル値を追加
worksheet.Cells("B2").PutValue(20)
' " B3" セルにサンプル値を追加
worksheet.Cells("B3").PutValue(50)
'ワークシートにチャートを追加
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'新しく追加されたチャートのインスタンスにアクセス
Dim chart As Chart = worksheet.Charts(chartIndex)
' " A1" セルから" B3" までの範囲のNSeries(チャートデータソース)をチャートに追加
chart.NSeries.Add("A1:B3", True)
'値軸の最大値を設定
chart.ValueAxis.MaxValue = 200
'値軸の最小値を設定
chart.ValueAxis.MinValue = 0
'主要単位を設定
chart.ValueAxis.MajorUnit = 25
'カテゴリ(X)軸が最大値で交差します。
chart.ValueAxis.CrossType = CrossType.Maximum
'ティックマークラベルの間のカテゴリまたはシリーズの数を設定します。
chart.CategoryAxis.TickLabelSpacing = 2
'Excelファイルを保存
workbook.Save("book1.xlsx")
プロパティ
Area
Aspose.Cells.Charts.Axis.Areaを取得します。
public Area Area { get; }
プロパティ値
AxisBetweenCategories
値軸がカテゴリ間でカテゴリ軸と交差するかどうかを表します。
public bool AxisBetweenCategories { get; set; }
プロパティ値
備考
このプロパティはカテゴリ軸にのみ適用され、3-Dチャートには適用されません。
AxisLine
軸の外観を取得します。
public Line AxisLine { get; }
プロパティ値
BaseUnitScale
カテゴリ軸の基準単位スケールを表します。
public TimeUnit BaseUnitScale { get; set; }
プロパティ値
備考
このプロパティを設定すると、CategoryTypeプロパティがTimeScaleに設定されているときのみ効果があります。
Bins
チャート(ヒストグラム/パレート)軸のビンを表します。
public AxisBins Bins { get; }
プロパティ値
CategoryType
カテゴリ軸のタイプを表します。
public CategoryType CategoryType { get; set; }
プロパティ値
CrossAt
カテゴリ軸が交差する値軸上の点を表します。
public double CrossAt { get; set; }
プロパティ値
備考
この数値は、カテゴリ軸に適用されるときは整数である必要があります。 そして、値は1から31999の間でなければなりません。
CrossType
他の軸が交差する指定された軸上のAspose.Cells.Charts.Axis.CrossTypeを表します。
public CrossType CrossType { get; set; }
プロパティ値
CustomDisplayUnit
表示単位のカスタム値を指定します。
public double CustomDisplayUnit { get; set; }
プロパティ値
DisplayUnit
指定された軸の単位ラベルを表します。
public DisplayUnitType DisplayUnit { get; set; }
プロパティ値
DisplayUnitLabel
指定されたチャートの軸上の単位ラベルを表します。 単位ラベルは、大きな値(たとえば、百万や十億)をチャート化する際に便利です。
public DisplayUnitLabel DisplayUnitLabel { get; }
プロパティ値
HasMultiLevelLabels
ラベルがマルチレベルで表示されるかどうかを示します。
public bool HasMultiLevelLabels { get; set; }
プロパティ値
備考
カテゴリ軸にのみ有効です。
IsAutoTickLabelSpacing
ティックラベルの間隔が自動かどうかを示します。
public bool IsAutoTickLabelSpacing { get; set; }
プロパティ値
IsAutomaticMajorUnit
軸の主要単位が自動的に割り当てられているかどうかを示します。
public bool IsAutomaticMajorUnit { get; set; }
プロパティ値
IsAutomaticMaxValue
最大値が自動的に割り当てられているかどうかを示します。
public bool IsAutomaticMaxValue { get; set; }
プロパティ値
IsAutomaticMinValue
最小値が自動的に割り当てられているかどうかを示します。
public bool IsAutomaticMinValue { get; set; }
プロパティ値
IsAutomaticMinorUnit
軸の小単位が自動的に割り当てられているかどうかを示します。
public bool IsAutomaticMinorUnit { get; set; }
プロパティ値
IsDisplayUnitLabelShown
指定された軸に表示単位ラベルが表示されているかどうかを表します。
public bool IsDisplayUnitLabelShown { get; set; }
プロパティ値
備考
デフォルト値はTrueです。
IsLogarithmic
値軸のスケールタイプが対数かどうかを表します。
public bool IsLogarithmic { get; set; }
プロパティ値
IsPlotOrderReversed
Microsoft Excelがデータポイントを最後から最初にプロットするかどうかを表します。
public bool IsPlotOrderReversed { get; set; }
プロパティ値
IsVisible
軸が表示されているかどうかを表します。
public bool IsVisible { get; set; }
プロパティ値
LogBase
対数の基数を表します。デフォルト値は10です。Excel2007のみに適用されます。
public double LogBase { get; set; }
プロパティ値
MajorGridLines
チャート軸の主要グリッドラインを表します。
public Line MajorGridLines { get; }
プロパティ値
例
chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true
MajorTickMark
指定された軸の主要ティックマークのタイプを表します。
public TickMarkType MajorTickMark { get; set; }
プロパティ値
MajorUnit
軸の主要単位を表します。
public double MajorUnit { get; set; }
プロパティ値
備考
主要単位はゼロより大きくなければなりません。
MajorUnitScale
カテゴリ軸の主要単位スケールを表します。
public TimeUnit MajorUnitScale { get; set; }
プロパティ値
例
chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MajorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months
chart.CategoryAxis.MajorUnit = 2
MaxValue
値軸の最大値を表します。
public object MaxValue { get; set; }
プロパティ値
備考
maxValueの型はdoubleまたはDateTimeのみです。
MinValue
値軸の最小値を表します。
public object MinValue { get; set; }
プロパティ値
備考
minValueの型はdoubleまたはDateTimeのみです。
MinorGridLines
チャート軸の小グリッドラインを表します。
public Line MinorGridLines { get; }
プロパティ値
MinorTickMark
指定された軸の小ティックマークのタイプを表します。
public TickMarkType MinorTickMark { get; set; }
プロパティ値
MinorUnit
軸の小単位を表します。
public double MinorUnit { get; set; }
プロパティ値
備考
小単位はゼロより大きくなければなりません。
MinorUnitScale
カテゴリ軸の主要単位スケールを表します。
public TimeUnit MinorUnitScale { get; set; }
プロパティ値
例
chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MinorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months
chart.CategoryAxis.MinorUnit = 2
TickLabelPosition
指定された軸のティックマークラベルの位置を表します。
public TickLabelPositionType TickLabelPosition { get; set; }
プロパティ値
TickLabelSpacing
ティックマークラベルの間のカテゴリまたはシリーズの数を表します。カテゴリ軸と系列軸にのみ適用されます。
public int TickLabelSpacing { get; set; }
プロパティ値
備考
その数は1から31999の間でなければなりません。
TickLabels
指定された軸のティックマークラベルを表すAspose.Cells.Charts.Axis.TickLabelsオブジェクトを返します。
public TickLabels TickLabels { get; }
プロパティ値
TickMarkSpacing
ティックマークの間のカテゴリまたはシリーズの数を返すか、設定します。カテゴリ軸と系列軸にのみ適用されます。
public int TickMarkSpacing { get; set; }
プロパティ値
備考
その数は1から31999の間でなければなりません。
Title
軸のタイトルを取得します。
public Title Title { get; }
プロパティ値
メソッド
GetAxisTexts()
Chart.Calculate()メソッドを呼び出した後、軸のラベルを取得します。
public string[] GetAxisTexts()
戻り値
string[]