Class Axis

Class Axis

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

チャートの軸を表すオブジェクトをカプセル化します。

public class Axis

継承

objectAxis

継承されたメンバー

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; }

プロパティ値

Area

AxisBetweenCategories

値軸がカテゴリ間でカテゴリ軸と交差するかどうかを表します。

public bool AxisBetweenCategories { get; set; }

プロパティ値

bool

備考

このプロパティはカテゴリ軸にのみ適用され、3-Dチャートには適用されません。

AxisLine

軸の外観を取得します。

public Line AxisLine { get; }

プロパティ値

Line

BaseUnitScale

カテゴリ軸の基準単位スケールを表します。

public TimeUnit BaseUnitScale { get; set; }

プロパティ値

TimeUnit

備考

このプロパティを設定すると、CategoryTypeプロパティがTimeScaleに設定されているときのみ効果があります。

Bins

チャート(ヒストグラム/パレート)軸のビンを表します。

public AxisBins Bins { get; }

プロパティ値

AxisBins

CategoryType

カテゴリ軸のタイプを表します。

public CategoryType CategoryType { get; set; }

プロパティ値

CategoryType

CrossAt

カテゴリ軸が交差する値軸上の点を表します。

public double CrossAt { get; set; }

プロパティ値

double

備考

この数値は、カテゴリ軸に適用されるときは整数である必要があります。 そして、値は1から31999の間でなければなりません。

CrossType

他の軸が交差する指定された軸上のAspose.Cells.Charts.Axis.CrossTypeを表します。

public CrossType CrossType { get; set; }

プロパティ値

CrossType

CustomDisplayUnit

表示単位のカスタム値を指定します。

public double CustomDisplayUnit { get; set; }

プロパティ値

double

DisplayUnit

指定された軸の単位ラベルを表します。

public DisplayUnitType DisplayUnit { get; set; }

プロパティ値

DisplayUnitType

DisplayUnitLabel

指定されたチャートの軸上の単位ラベルを表します。 単位ラベルは、大きな値(たとえば、百万や十億)をチャート化する際に便利です。

public DisplayUnitLabel DisplayUnitLabel { get; }

プロパティ値

DisplayUnitLabel

HasMultiLevelLabels

ラベルがマルチレベルで表示されるかどうかを示します。

public bool HasMultiLevelLabels { get; set; }

プロパティ値

bool

備考

カテゴリ軸にのみ有効です。

IsAutoTickLabelSpacing

ティックラベルの間隔が自動かどうかを示します。

public bool IsAutoTickLabelSpacing { get; set; }

プロパティ値

bool

IsAutomaticMajorUnit

軸の主要単位が自動的に割り当てられているかどうかを示します。

public bool IsAutomaticMajorUnit { get; set; }

プロパティ値

bool

IsAutomaticMaxValue

最大値が自動的に割り当てられているかどうかを示します。

public bool IsAutomaticMaxValue { get; set; }

プロパティ値

bool

IsAutomaticMinValue

最小値が自動的に割り当てられているかどうかを示します。

public bool IsAutomaticMinValue { get; set; }

プロパティ値

bool

IsAutomaticMinorUnit

軸の小単位が自動的に割り当てられているかどうかを示します。

public bool IsAutomaticMinorUnit { get; set; }

プロパティ値

bool

IsDisplayUnitLabelShown

指定された軸に表示単位ラベルが表示されているかどうかを表します。

public bool IsDisplayUnitLabelShown { get; set; }

プロパティ値

bool

備考

デフォルト値はTrueです。

IsLogarithmic

値軸のスケールタイプが対数かどうかを表します。

public bool IsLogarithmic { get; set; }

プロパティ値

bool

IsPlotOrderReversed

Microsoft Excelがデータポイントを最後から最初にプロットするかどうかを表します。

public bool IsPlotOrderReversed { get; set; }

プロパティ値

bool

IsVisible

軸が表示されているかどうかを表します。

public bool IsVisible { get; set; }

プロパティ値

bool

LogBase

対数の基数を表します。デフォルト値は10です。Excel2007のみに適用されます。

public double LogBase { get; set; }

プロパティ値

double

MajorGridLines

チャート軸の主要グリッドラインを表します。

public Line MajorGridLines { get; }

プロパティ値

Line

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; }

プロパティ値

TickMarkType

MajorUnit

軸の主要単位を表します。

public double MajorUnit { get; set; }

プロパティ値

double

備考

主要単位はゼロより大きくなければなりません。

MajorUnitScale

カテゴリ軸の主要単位スケールを表します。

public TimeUnit MajorUnitScale { get; set; }

プロパティ値

TimeUnit

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; }

プロパティ値

object

備考

maxValueの型はdoubleまたはDateTimeのみです。

MinValue

値軸の最小値を表します。

public object MinValue { get; set; }

プロパティ値

object

備考

minValueの型はdoubleまたはDateTimeのみです。

MinorGridLines

チャート軸の小グリッドラインを表します。

public Line MinorGridLines { get; }

プロパティ値

Line

MinorTickMark

指定された軸の小ティックマークのタイプを表します。

public TickMarkType MinorTickMark { get; set; }

プロパティ値

TickMarkType

MinorUnit

軸の小単位を表します。

public double MinorUnit { get; set; }

プロパティ値

double

備考

小単位はゼロより大きくなければなりません。

MinorUnitScale

カテゴリ軸の主要単位スケールを表します。

public TimeUnit MinorUnitScale { get; set; }

プロパティ値

TimeUnit

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; }

プロパティ値

TickLabelPositionType

TickLabelSpacing

ティックマークラベルの間のカテゴリまたはシリーズの数を表します。カテゴリ軸と系列軸にのみ適用されます。

public int TickLabelSpacing { get; set; }

プロパティ値

int

備考

その数は1から31999の間でなければなりません。

TickLabels

指定された軸のティックマークラベルを表すAspose.Cells.Charts.Axis.TickLabelsオブジェクトを返します。

public TickLabels TickLabels { get; }

プロパティ値

TickLabels

TickMarkSpacing

ティックマークの間のカテゴリまたはシリーズの数を返すか、設定します。カテゴリ軸と系列軸にのみ適用されます。

public int TickMarkSpacing { get; set; }

プロパティ値

int

備考

その数は1から31999の間でなければなりません。

Title

軸のタイトルを取得します。

public Title Title { get; }

プロパティ値

Title

メソッド

GetAxisTexts()

Chart.Calculate()メソッドを呼び出した後、軸のラベルを取得します。

public string[] GetAxisTexts()

戻り値

string[]

 日本語