Excel.ChartAxis class

グラフの 1 つの軸を表します。Represents a single axis in a chart.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

Extends

プロパティ

alignment

指定した軸の目盛ラベルの配置を表します。Represents the alignment for the specified axis tick label. 詳細については、「ChartTextHorizontalAlignment」を参照してください。See Excel.ChartTextHorizontalAlignment for detail.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

axisGroup

指定した軸に対応するグループを表します。Represents the group for the specified axis. 詳細については、「ChartAxisGroup」を参照してください。See Excel.ChartAxisGroup for details. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

baseTimeUnit

指定された項目軸の基本単位を返すか設定します。Returns or sets the base unit for the specified category axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

categoryType

項目軸の種類を返すか設定します。Returns or sets the category axis type.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

context

オブジェクトに関連付けられている要求コンテキスト。The request context associated with the object. これにより、アドインのプロセスが Office ホストアプリケーションのプロセスに接続されます。This connects the add-in's process to the Office host application's process.

customDisplayUnit

カスタム軸の表示単位の値を表します。Represents the custom axis display unit value. 読み取り専用です。Read-only. このプロパティを設定するには、SetCustomDisplayUnit(double) メソッドを使用してください。To set this property, please use the SetCustomDisplayUnit(double) method.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

displayUnit

軸の表示単位を表します。Represents the axis display unit. 詳細については、「ChartAxisDisplayUnit」を参照してください。See Excel.ChartAxisDisplayUnit for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

format

グラフオブジェクトの書式を表します。これには、行とフォントの書式設定が含まれます。Represents the formatting of a chart object, which includes line and font formatting. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

height

グラフ軸の高さ (ポイント数) を表します。Represents the height, in points, of the chart axis. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

isBetweenCategories

項目の境界で数値軸が項目軸と交差するかどうかを表します。Represents whether value axis crosses the category axis between categories.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

left

軸の左端からグラフ エリアの左端までの距離 (ポイント数) を表します。Represents the distance, in points, from the left edge of the axis to the left of chart area. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

linkNumberFormat

数値の書式をセルにリンクするかどうかを表します。Represents whether or not the number format is linked to the cells. True の場合は、セル内のラベルが変更されるときに、数値の書式が変更されます。If true, the number format will change in the labels when it changes in the cells.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

logBase

対数目盛りを使用する場合の対数の底を表します。Represents the base of the logarithm when using logarithmic scales.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

majorGridlines

指定された軸の大きい目盛線を表す Gridlines オブジェクトを返します。Returns a Gridlines object that represents the major gridlines for the specified axis. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

majorTickMark

指定した軸の目盛の種類を表します。Represents the type of major tick mark for the specified axis. 詳細については、「ChartAxisTickMark」を参照してください。See Excel.ChartAxisTickMark for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

majorTimeUnitScale

CategoryType プロパティが lTimeScale に設定されている場合、項目軸の目盛のスケール値を返すか設定します。Returns or sets the major unit scale value for the category axis when the CategoryType property is set to TimeScale.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

majorUnit

2 つの大きい目盛の間隔を表します。Represents the interval between two major tick marks. 数値の値または空の文字列を設定できます。Can be set to a numeric value or an empty string. 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

maximum

数値軸の最大値を表します。Represents the maximum value on the value axis. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

minimum

数値軸の最小値を表します。Represents the minimum value on the value axis. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

minorGridlines

指定された軸の小さい目盛線を表す gridlines オブジェクトを返します。Returns a Gridlines object that represents the minor gridlines for the specified axis. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

minorTickMark

指定した軸の補助目盛の種類を表します。Represents the type of minor tick mark for the specified axis. 詳細については、「ChartAxisTickMark」を参照してください。See Excel.ChartAxisTickMark for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

minorTimeUnitScale

CategoryType プロパティが lTimeScale に設定されている場合、項目軸の補助目盛のスケール値を返すか設定します。Returns or sets the minor unit scale value for the category axis when the CategoryType property is set to TimeScale.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

minorUnit

2 つの小さい目盛の間隔を表します。Represents the interval between two minor tick marks. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

multiLevel

軸がマルチレベルかどうかを表します。Represents whether an axis is multilevel or not.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

numberFormat

軸の目盛ラベルの書式コードを表します。Represents the format code for the axis tick label.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

offset

ラベルのレベル間の距離、および先頭レベルと軸線との距離を表します。Represents the distance between the levels of labels, and the distance between the first level and the axis line. 値は 0 から 1000 の範囲内でなければなりません。The value should be an integer from 0 to 1000.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

position

指定した軸と他の軸との交差位置を表します。Represents the specified axis position where the other axis crosses. 詳細については、「ChartAxisPosition」を参照してください。See Excel.ChartAxisPosition for details.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

positionAt

指定した軸と他の軸との交差位置を表します。Represents the specified axis position where the other axis crosses at. このプロパティを設定するには、SetPositionAt(double) メソッドを使用する必要があります。You should use the SetPositionAt(double) method to set this property.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

reversePlotOrder

Microsoft Excel でデータ ポイントを最後から最初への順でプロットするかどうかを表します。Represents whether Microsoft Excel plots data points from last to first.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

scaleType

数値軸のスケールの種類を表します。Represents the value axis scale type. 詳細については、「ChartAxisScaleType」を参照してください。See Excel.ChartAxisScaleType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

showDisplayUnitLabel

軸の表示単位のラベルを表示するかどうかを表します。Represents whether the axis display unit label is visible.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

textOrientation

軸の目盛ラベルのテキストの向きを表します。Represents the text orientation of the axis tick label. 値は -90 から 90 の範囲内の整数か、縦書きテキストの場合は 180 でなければなりません。The value should be an integer either from -90 to 90, or 180 for vertically-oriented text.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

tickLabelPosition

指定した軸での目盛ラベルの位置を示します。Represents the position of tick-mark labels on the specified axis. 詳細については、「ChartAxisTickLabelPosition」を参照してください。See Excel.ChartAxisTickLabelPosition for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

tickLabelSpacing

目盛ラベル間の項目または系列の数を表します。Represents the number of categories or series between tick-mark labels. 1 から 31999 の範囲内で値を設定できます。自動的に設定する場合は、空の文字列にします。Can be a value from 1 through 31999 or an empty string for automatic setting. 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

tickMarkSpacing

目盛間の項目または系列の数を表します。Represents the number of categories or series between tick marks.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

title

軸タイトルを表します。Represents the axis title. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

top

軸の上端からグラフ エリアの上端までの距離 (ポイント数) を表します。Represents the distance, in points, from the top edge of the axis to the top of chart area. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

type

軸の種類を表します。Represents the axis type. 詳細については、「ChartAxisType」を参照してください。See Excel.ChartAxisType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

visible

軸を表示するかどうかを表すブール値。A boolean value represents the visibility of the axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

width

グラフ軸の幅 (ポイント数) を表します。Represents the width, in points, of the chart axis. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

メソッド

load(option)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るには先に "context.sync()" を呼び出す必要があります。You must call "context.sync()" before reading the properties.

load(propertyNames)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

load(propertyNamesAndPaths)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

set(properties, options)

一度に1つのオブジェクトの複数のプロパティを設定します。Sets multiple properties of an object at the same time. 適切なプロパティを持つプレーンオブジェクト、または同じ種類の別の API オブジェクトのいずれかを渡すことができます。You can pass either a plain object with the appropriate properties, or another API object of the same type.

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを設定します。Sets multiple properties on the object at the same time, based on an existing loaded object.

setCategoryNames(sourceData)

指定した軸のすべてのカテゴリ名を設定します。Sets all the category names for the specified axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setCustomDisplayUnit(value)

軸の表示単位をカスタム値に設定します。Sets the axis display unit to a custom value.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setPositionAt(value)

指定した軸と他の軸との交差位置を設定します。Set the specified axis position where the other axis crosses at.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

toJSON()

API オブジェクトがtoJSON()渡されるときに、より有用な出力を提供するために、JavaScript メソッドをオーバーライドします。JSON.stringify()Overrides the JavaScript toJSON() method in order to provide more useful output when an API object is passed to JSON.stringify(). (JSON.stringifyその後、渡されたtoJSONオブジェクトのメソッドを呼び出します。元の ChartAxis オブジェクトは API オブジェクトであるのに対し、 toJSONメソッドはプレーンな JavaScript オブジェクトを返します (型はExcel.Interfaces.ChartAxisData, in turn, calls the toJSON method of the object that is passed to it.) Whereas the original Excel.ChartAxis object is an API object, the toJSON method returns a plain JavaScript object (typed as Excel.Interfaces.ChartAxisData) は、元のオブジェクトから読み込まれた子プロパティの浅いコピーを格納します。) that contains shallow copies of any loaded child properties from the original object.

プロパティの詳細

alignment

指定した軸の目盛ラベルの配置を表します。Represents the alignment for the specified axis tick label. 詳細については、「ChartTextHorizontalAlignment」を参照してください。See Excel.ChartTextHorizontalAlignment for detail.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

alignment: Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right";

プロパティ値

Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right"

axisGroup

指定した軸に対応するグループを表します。Represents the group for the specified axis. 詳細については、「ChartAxisGroup」を参照してください。See Excel.ChartAxisGroup for details. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";

プロパティ値

Excel.ChartAxisGroup | "Primary" | "Secondary"

baseTimeUnit

指定された項目軸の基本単位を返すか設定します。Returns or sets the base unit for the specified category axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

baseTimeUnit: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

プロパティ値

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

categoryType

項目軸の種類を返すか設定します。Returns or sets the category axis type.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

categoryType: Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis";

プロパティ値

Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis"

context

オブジェクトに関連付けられている要求コンテキスト。The request context associated with the object. これにより、アドインのプロセスが Office ホストアプリケーションのプロセスに接続されます。This connects the add-in's process to the Office host application's process.

context: RequestContext;

プロパティ値

RequestContext

customDisplayUnit

カスタム軸の表示単位の値を表します。Represents the custom axis display unit value. 読み取り専用です。Read-only. このプロパティを設定するには、SetCustomDisplayUnit(double) メソッドを使用してください。To set this property, please use the SetCustomDisplayUnit(double) method.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly customDisplayUnit: number;

プロパティ値

number

displayUnit

軸の表示単位を表します。Represents the axis display unit. 詳細については、「ChartAxisDisplayUnit」を参照してください。See Excel.ChartAxisDisplayUnit for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

displayUnit: Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom";

プロパティ値

Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom"

Examples

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");

    let chart = sheet.charts.getItemAt(0);
    let categoryAxis = chart.axes.categoryAxis;
    let valueAxis = chart.axes.valueAxis;

    // Load to get display unit.
    valueAxis.load("displayUnit");

    await context.sync();

    console.log("The vertical axis display unit is: " + valueAxis.displayUnit);
});

format

グラフオブジェクトの書式を表します。これには、行とフォントの書式設定が含まれます。Represents the formatting of a chart object, which includes line and font formatting. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly format: Excel.ChartAxisFormat;

プロパティ値

height

グラフ軸の高さ (ポイント数) を表します。Represents the height, in points, of the chart axis. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly height: number;

プロパティ値

number

isBetweenCategories

項目の境界で数値軸が項目軸と交差するかどうかを表します。Represents whether value axis crosses the category axis between categories.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

isBetweenCategories: boolean;

プロパティ値

boolean

left

軸の左端からグラフ エリアの左端までの距離 (ポイント数) を表します。Represents the distance, in points, from the left edge of the axis to the left of chart area. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly left: number;

プロパティ値

number

linkNumberFormat

数値の書式をセルにリンクするかどうかを表します。Represents whether or not the number format is linked to the cells. True の場合は、セル内のラベルが変更されるときに、数値の書式が変更されます。If true, the number format will change in the labels when it changes in the cells.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

linkNumberFormat: boolean;

プロパティ値

boolean

logBase

対数目盛りを使用する場合の対数の底を表します。Represents the base of the logarithm when using logarithmic scales.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

logBase: number;

プロパティ値

number

majorGridlines

指定された軸の大きい目盛線を表す Gridlines オブジェクトを返します。Returns a Gridlines object that represents the major gridlines for the specified axis. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly majorGridlines: Excel.ChartGridlines;

プロパティ値

majorTickMark

指定した軸の目盛の種類を表します。Represents the type of major tick mark for the specified axis. 詳細については、「ChartAxisTickMark」を参照してください。See Excel.ChartAxisTickMark for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

majorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

プロパティ値

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

majorTimeUnitScale

CategoryType プロパティが lTimeScale に設定されている場合、項目軸の目盛のスケール値を返すか設定します。Returns or sets the major unit scale value for the category axis when the CategoryType property is set to TimeScale.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

majorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

プロパティ値

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

majorUnit

2 つの大きい目盛の間隔を表します。Represents the interval between two major tick marks. 数値の値または空の文字列を設定できます。Can be set to a numeric value or an empty string. 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

majorUnit: any;

プロパティ値

any

maximum

数値軸の最大値を表します。Represents the maximum value on the value axis. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

maximum: any;

プロパティ値

any

minimum

数値軸の最小値を表します。Represents the minimum value on the value axis. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

minimum: any;

プロパティ値

any

minorGridlines

指定された軸の小さい目盛線を表す gridlines オブジェクトを返します。Returns a Gridlines object that represents the minor gridlines for the specified axis. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly minorGridlines: Excel.ChartGridlines;

プロパティ値

minorTickMark

指定した軸の補助目盛の種類を表します。Represents the type of minor tick mark for the specified axis. 詳細については、「ChartAxisTickMark」を参照してください。See Excel.ChartAxisTickMark for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

minorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

プロパティ値

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

minorTimeUnitScale

CategoryType プロパティが lTimeScale に設定されている場合、項目軸の補助目盛のスケール値を返すか設定します。Returns or sets the minor unit scale value for the category axis when the CategoryType property is set to TimeScale.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

minorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

プロパティ値

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

minorUnit

2 つの小さい目盛の間隔を表します。Represents the interval between two minor tick marks. 数値の値または空の文字列を設定できます (軸の値が自動の場合)。Can be set to a numeric value or an empty string (for automatic axis values). 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

minorUnit: any;

プロパティ値

any

multiLevel

軸がマルチレベルかどうかを表します。Represents whether an axis is multilevel or not.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

multiLevel: boolean;

プロパティ値

boolean

numberFormat

軸の目盛ラベルの書式コードを表します。Represents the format code for the axis tick label.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

numberFormat: string;

プロパティ値

string

offset

ラベルのレベル間の距離、および先頭レベルと軸線との距離を表します。Represents the distance between the levels of labels, and the distance between the first level and the axis line. 値は 0 から 1000 の範囲内でなければなりません。The value should be an integer from 0 to 1000.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

offset: number;

プロパティ値

number

position

指定した軸と他の軸との交差位置を表します。Represents the specified axis position where the other axis crosses. 詳細については、「ChartAxisPosition」を参照してください。See Excel.ChartAxisPosition for details.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

position: Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom";

プロパティ値

Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom"

positionAt

指定した軸と他の軸との交差位置を表します。Represents the specified axis position where the other axis crosses at. このプロパティを設定するには、SetPositionAt(double) メソッドを使用する必要があります。You should use the SetPositionAt(double) method to set this property.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

readonly positionAt: number;

プロパティ値

number

reversePlotOrder

Microsoft Excel でデータ ポイントを最後から最初への順でプロットするかどうかを表します。Represents whether Microsoft Excel plots data points from last to first.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

reversePlotOrder: boolean;

プロパティ値

boolean

scaleType

数値軸のスケールの種類を表します。Represents the value axis scale type. 詳細については、「ChartAxisScaleType」を参照してください。See Excel.ChartAxisScaleType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

scaleType: Excel.ChartAxisScaleType | "Linear" | "Logarithmic";

プロパティ値

Excel.ChartAxisScaleType | "Linear" | "Logarithmic"

showDisplayUnitLabel

軸の表示単位のラベルを表示するかどうかを表します。Represents whether the axis display unit label is visible.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

showDisplayUnitLabel: boolean;

プロパティ値

boolean

Examples

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    let chart = sheet.charts.getItemAt(0);
    let axis = chart.axes.valueAxis;

    // Remove display unit.
    axis.showDisplayUnitLabel = false;

    await context.sync();
});

textOrientation

軸の目盛ラベルのテキストの向きを表します。Represents the text orientation of the axis tick label. 値は -90 から 90 の範囲内の整数か、縦書きテキストの場合は 180 でなければなりません。The value should be an integer either from -90 to 90, or 180 for vertically-oriented text.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

textOrientation: any;

プロパティ値

any

tickLabelPosition

指定した軸での目盛ラベルの位置を示します。Represents the position of tick-mark labels on the specified axis. 詳細については、「ChartAxisTickLabelPosition」を参照してください。See Excel.ChartAxisTickLabelPosition for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

tickLabelPosition: Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None";

プロパティ値

Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None"

tickLabelSpacing

目盛ラベル間の項目または系列の数を表します。Represents the number of categories or series between tick-mark labels. 1 から 31999 の範囲内で値を設定できます。自動的に設定する場合は、空の文字列にします。Can be a value from 1 through 31999 or an empty string for automatic setting. 戻り値は常に数値です。The returned value is always a number.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

tickLabelSpacing: any;

プロパティ値

any

tickMarkSpacing

目盛間の項目または系列の数を表します。Represents the number of categories or series between tick marks.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

tickMarkSpacing: number;

プロパティ値

number

title

軸タイトルを表します。Represents the axis title. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly title: Excel.ChartAxisTitle;

プロパティ値

top

軸の上端からグラフ エリアの上端までの距離 (ポイント数) を表します。Represents the distance, in points, from the top edge of the axis to the top of chart area. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly top: number;

プロパティ値

number

type

軸の種類を表します。Represents the axis type. 詳細については、「ChartAxisType」を参照してください。See Excel.ChartAxisType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly type: Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series";

プロパティ値

Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series"

visible

軸を表示するかどうかを表すブール値。A boolean value represents the visibility of the axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

visible: boolean;

プロパティ値

boolean

width

グラフ軸の幅 (ポイント数) を表します。Represents the width, in points, of the chart axis. 軸が非表示の場合は Null。Null if the axis is not visible. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly width: number;

プロパティ値

number

メソッドの詳細

load(option)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るには先に "context.sync()" を呼び出す必要があります。You must call "context.sync()" before reading the properties.

load(option?: Excel.Interfaces.ChartAxisLoadOptions): Excel.ChartAxis;

パラメーター

戻り値

注釈

このシグネチャに加えて、このメソッドのシグネチャは次のとおりです。In addition to this signature, this method has the following signatures:

load(option?: string | string[]): Excel.ChartAxis-Where オプションは、読み込むプロパティを指定する、コンマで区切られた文字列または文字列の配列です。load(option?: string | string[]): Excel.ChartAxis - Where option is a comma-delimited string or an array of strings that specify the properties to load.

load(option?: { select?: string; expand?: string; }): Excel.ChartAxis-Where オプションを指定します。 select は、読み込むプロパティを指定するコンマで区切られた文字列で、オプション expand は読み込むナビゲーションプロパティを指定するコンマ区切りの文字列です。load(option?: { select?: string; expand?: string; }): Excel.ChartAxis - Where option.select is a comma-delimited string that specifies the properties to load, and options.expand is a comma-delimited string that specifies the navigation properties to load.

load(option?: { select?: string; expand?: string; top?: number; skip?: number }): Excel.ChartAxis-コレクション型でのみ使用できます。load(option?: { select?: string; expand?: string; top?: number; skip?: number }): Excel.ChartAxis - Only available on collection types. これは、前述の署名に似ています。It is similar to the preceding signature. Top は、結果に含めることができるコレクション項目の最大数を指定します。Option.top specifies the maximum number of collection items that can be included in the result. 省略すると、スキップされ、結果に含まれないアイテムの数を指定します。Option.skip specifies the number of items that are to be skipped and not included in the result. Option を指定すると、指定した数のアイテムをスキップした後に結果セットが開始されます。If option.top is specified, the result set will start after skipping the specified number of items.

load(propertyNames)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

load(propertyNames?: string | string[]): Excel.ChartAxis;

パラメーター

propertyNames
string | string[]

読み込むプロパティを指定する、コンマで区切られた文字列または文字列の配列。A comma-delimited string or an array of strings that specify the properties to load.

戻り値

Examples

// Get the maximum of Chart Axis from Chart1
Excel.run(function (ctx) { 
    var chart = ctx.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");    
    var axis = chart.axes.valueAxis;
    axis.load('maximum');
    return ctx.sync().then(function() {
            console.log(axis.maximum);
    });
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});
// Set the maximum, minimum, majorunit, minorunit of valueaxis. 
Excel.run(function (ctx) { 
    var chart = ctx.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");    
    chart.axes.valueAxis.maximum = 5;
    chart.axes.valueAxis.minimum = 0;
    chart.axes.valueAxis.majorUnit = 1;
    chart.axes.valueAxis.minorUnit = 0.2;
    return ctx.sync().then(function() {
            console.log("Axis Settings Changed");
    });
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

load(propertyNamesAndPaths)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

load(propertyNamesAndPaths?: { select?: string; expand?: string; }): Excel.ChartAxis;

パラメーター

propertyNamesAndPaths
{ select?: string; expand?: string; }

ここで、は、読み込むプロパティを指定するコンマで区切られた文字列を指定します。 expand は、読み込むナビゲーションプロパティを指定するコンマ区切りの文字列です。Where propertyNamesAndPaths.select is a comma-delimited string that specifies the properties to load, and propertyNamesAndPaths.expand is a comma-delimited string that specifies the navigation properties to load.

戻り値

set(properties, options)

一度に1つのオブジェクトの複数のプロパティを設定します。Sets multiple properties of an object at the same time. 適切なプロパティを持つプレーンオブジェクト、または同じ種類の別の API オブジェクトのいずれかを渡すことができます。You can pass either a plain object with the appropriate properties, or another API object of the same type.

set(properties: Interfaces.ChartAxisUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

properties
Interfaces.ChartAxisUpdateData

メソッドが呼び出されるオブジェクトのプロパティに構造化 isomorphically されているプロパティを持つ JavaScript オブジェクト。A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.

options
OfficeExtension.UpdateOptions

プロパティオブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。Provides an option to suppress errors if the properties object tries to set any read-only properties.

戻り値

void

注釈

このメソッドには、次の追加のシグネチャがあります。This method has the following additional signature:

set(properties: Excel.ChartAxis): void

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを設定します。Sets multiple properties on the object at the same time, based on an existing loaded object.

set(properties: Excel.ChartAxis): void;

パラメーター

properties
Excel.ChartAxis

戻り値

void

setCategoryNames(sourceData)

指定した軸のすべてのカテゴリ名を設定します。Sets all the category names for the specified axis.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setCategoryNames(sourceData: Range): void;

パラメーター

sourceData
Range

データ ソースに対応する Range オブジェクトです。The Range object corresponding to the source data.

戻り値

void

setCustomDisplayUnit(value)

軸の表示単位をカスタム値に設定します。Sets the axis display unit to a custom value.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setCustomDisplayUnit(value: number): void;

パラメーター

value
number

表示単位のカスタム値。Custom value of the display unit.

戻り値

void

setPositionAt(value)

指定した軸と他の軸との交差位置を設定します。Set the specified axis position where the other axis crosses at.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

setPositionAt(value: number): void;

パラメーター

value
number

の交差のカスタム値Custom value of the crosses at

戻り値

void

toJSON()

API オブジェクトがtoJSON()渡されるときに、より有用な出力を提供するために、JavaScript メソッドをオーバーライドします。JSON.stringify()Overrides the JavaScript toJSON() method in order to provide more useful output when an API object is passed to JSON.stringify(). (JSON.stringifyその後、渡されたtoJSONオブジェクトのメソッドを呼び出します。元の ChartAxis オブジェクトは API オブジェクトであるのに対し、 toJSONメソッドはプレーンな JavaScript オブジェクトを返します (型はExcel.Interfaces.ChartAxisData, in turn, calls the toJSON method of the object that is passed to it.) Whereas the original Excel.ChartAxis object is an API object, the toJSON method returns a plain JavaScript object (typed as Excel.Interfaces.ChartAxisData) は、元のオブジェクトから読み込まれた子プロパティの浅いコピーを格納します。) that contains shallow copies of any loaded child properties from the original object.

toJSON(): Excel.Interfaces.ChartAxisData;

戻り値