ExcelScript.ChartAxis interface
Представляет одну ось на диаграмме.
Замечания
Примеры
/**
* This sample customizes the value axis of a chart.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Customize the value axis.
const valueAxis = chart.getAxes().getValueAxis();
valueAxis.setMinimum(40000);
valueAxis.setMaximum(60000);
valueAxis.setDisplayUnit(ExcelScript.ChartAxisDisplayUnit.thousands);
}
Методика
| get |
Задает выравнивание для указанной метки тика оси. Дополнительные сведения см. в статье |
| get |
Указывает группу для указанной оси. Дополнительные сведения см. в этой |
| get |
Указывает базовую единицу для указанной оси категорий. |
| get |
Указывает тип оси категории. |
| get |
Задает значение единицы отображения пользовательской оси. Чтобы задать это свойство, используйте |
| get |
Представляет отображаемую единицу измерения оси. Дополнительные сведения см. в этой |
| get |
Представляет форматирование объекта диаграммы, в том числе форматирование линий и шрифта. |
| get |
Указывает высоту (в точках) оси диаграммы. Возвращает значение |
| get |
Указывает, пересекает ли ось значений ось категорий между категориями. |
| get |
Указывает расстояние (в точках) от левого края оси до левого края области диаграммы. Возвращает значение |
| get |
Указывает, связан ли числовой формат с ячейками. Если |
| get |
Задает основание логарифма при использовании логарифмических шкал. |
| get |
Возвращает объект , представляющий основные линии сетки для указанной оси. |
| get |
Указывает тип основной отметки для указанной оси. Дополнительные сведения см. в этой |
| get |
Задает значение шкалы основной единицы для оси категорий, если свойству |
| get |
Задает интервал между двумя основными отметками. |
| get |
Задает максимальное значение на оси значений. |
| get |
Задает минимальное значение на оси значений. |
| get |
Возвращает объект , представляющий дополнительные линии сетки для указанной оси. |
| get |
Указывает тип дополнительной отметки для указанной оси. Дополнительные сведения см. в этой |
| get |
Указывает дополнительное значение шкалы единицы для оси категорий, если |
| get |
Указывает интервал между двумя незначительными отметками. |
| get |
Указывает, является ли ось многоуровневой. |
| get |
Задает код формата для метки такта оси. |
| get |
Указывает расстояние между уровнями меток и расстояние между первым уровнем и линией оси. Значение должно быть целым числом от 0 до 1000. |
| get |
Указывает указанное положение оси, в котором пересекаются другие оси. Дополнительные сведения см. в этой |
| get |
Указывает положение оси, в которой пересекаются другие оси. Для задания этого свойства следует использовать |
| get |
Указывает, отображает ли Excel точки данных от последней до первой. |
| get |
Указывает тип масштабирования оси значений. Дополнительные сведения см. в этой |
| get |
Указывает, отображается ли метка единицы отображения оси. |
| get |
Указывает угол, на который текст ориентирован для метки тика оси диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста. |
| get |
Указывает положение меток галочки на указанной оси. Дополнительные сведения см. в этой |
| get |
Указывает количество категорий или рядов между метками. Может быть значением от 1 до 31999. |
| get |
Указывает количество категорий или рядов между метками. |
| get |
Обозначает название оси. |
| get |
Указывает расстояние (в точках) от верхнего края оси до верхней части области диаграммы. Возвращает значение |
| get |
Указывает тип оси. Дополнительные сведения см. в этой |
| get |
Указывает, видна ли ось. |
| get |
Задает ширину (в точках) оси диаграммы. Возвращает значение |
| set |
Задает выравнивание для указанной метки тика оси. Дополнительные сведения см. в статье |
| set |
Указывает базовую единицу для указанной оси категорий. |
| set |
Устанавливает все имена категорий для указанной оси. |
| set |
Указывает тип оси категории. |
| set |
Задает отображаемую единицу измерения оси в виде настраиваемого значения. |
| set |
Представляет отображаемую единицу измерения оси. Дополнительные сведения см. в этой |
| set |
Указывает, пересекает ли ось значений ось категорий между категориями. |
| set |
Указывает, связан ли числовой формат с ячейками. Если |
| set |
Задает основание логарифма при использовании логарифмических шкал. |
| set |
Указывает тип основной отметки для указанной оси. Дополнительные сведения см. в этой |
| set |
Задает значение шкалы основной единицы для оси категорий, если свойству |
| set |
Задает интервал между двумя основными отметками. |
| set |
Задает максимальное значение на оси значений. |
| set |
Задает минимальное значение на оси значений. |
| set |
Указывает тип дополнительной отметки для указанной оси. Дополнительные сведения см. в этой |
| set |
Указывает дополнительное значение шкалы единицы для оси категорий, если |
| set |
Указывает интервал между двумя незначительными отметками. |
| set |
Указывает, является ли ось многоуровневой. |
| set |
Задает код формата для метки такта оси. |
| set |
Указывает расстояние между уровнями меток и расстояние между первым уровнем и линией оси. Значение должно быть целым числом от 0 до 1000. |
| set |
Указывает указанное положение оси, в котором пересекаются другие оси. Дополнительные сведения см. в этой |
| set |
Задает указанное положение оси, в котором пересекаются другие оси. |
| set |
Указывает, отображает ли Excel точки данных от последней до первой. |
| set |
Указывает тип масштабирования оси значений. Дополнительные сведения см. в этой |
| set |
Указывает, отображается ли метка единицы отображения оси. |
| set |
Указывает угол, на который текст ориентирован для метки тика оси диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста. |
| set |
Указывает положение меток галочки на указанной оси. Дополнительные сведения см. в этой |
| set |
Указывает количество категорий или рядов между метками. Может быть значением от 1 до 31999. |
| set |
Указывает количество категорий или рядов между метками. |
| set |
Указывает, видна ли ось. |
Подробнее о методе
getAlignment()
Задает выравнивание для указанной метки тика оси. Дополнительные сведения см. в статье ExcelScript.ChartTextHorizontalAlignment .
getAlignment(): ChartTickLabelAlignment;
Возвращает
getAxisGroup()
Указывает группу для указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisGroup статье.
getAxisGroup(): ChartAxisGroup;
Возвращает
getBaseTimeUnit()
Указывает базовую единицу для указанной оси категорий.
getBaseTimeUnit(): ChartAxisTimeUnit;
Возвращает
getCategoryType()
Указывает тип оси категории.
getCategoryType(): ChartAxisCategoryType;
Возвращает
getCustomDisplayUnit()
Задает значение единицы отображения пользовательской оси. Чтобы задать это свойство, используйте SetCustomDisplayUnit(double) метод .
getCustomDisplayUnit(): number;
Возвращает
number
getDisplayUnit()
Представляет отображаемую единицу измерения оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisDisplayUnit статье.
getDisplayUnit(): ChartAxisDisplayUnit;
Возвращает
getFormat()
Представляет форматирование объекта диаграммы, в том числе форматирование линий и шрифта.
getFormat(): ChartAxisFormat;
Возвращает
getHeight()
Указывает высоту (в точках) оси диаграммы. Возвращает значение null , если ось не видна.
getHeight(): number;
Возвращает
number
getIsBetweenCategories()
Указывает, пересекает ли ось значений ось категорий между категориями.
getIsBetweenCategories(): boolean;
Возвращает
boolean
getLeft()
Указывает расстояние (в точках) от левого края оси до левого края области диаграммы. Возвращает значение null , если ось не видна.
getLeft(): number;
Возвращает
number
getLinkNumberFormat()
Указывает, связан ли числовой формат с ячейками. Если trueзадано значение , числовой формат изменится в метках при изменении в ячейках.
getLinkNumberFormat(): boolean;
Возвращает
boolean
getLogBase()
Задает основание логарифма при использовании логарифмических шкал.
getLogBase(): number;
Возвращает
number
getMajorGridlines()
Возвращает объект , представляющий основные линии сетки для указанной оси.
getMajorGridlines(): ChartGridlines;
Возвращает
Примеры
/**
* This sample customizes the gridline color on a chart's value axis.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the gridline color to gray.
chart.getAxes().getValueAxis().getMajorGridlines().getFormat().getLine().setColor("gray");
}
getMajorTickMark()
Указывает тип основной отметки для указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickMark статье.
getMajorTickMark(): ChartAxisTickMark;
Возвращает
getMajorTimeUnitScale()
Задает значение шкалы основной единицы для оси категорий, если свойству categoryType присвоено значение dateAxis.
getMajorTimeUnitScale(): ChartAxisTimeUnit;
Возвращает
getMajorUnit()
Задает интервал между двумя основными отметками.
getMajorUnit(): number;
Возвращает
number
getMaximum()
Задает максимальное значение на оси значений.
getMaximum(): number;
Возвращает
number
getMinimum()
Задает минимальное значение на оси значений.
getMinimum(): number;
Возвращает
number
getMinorGridlines()
Возвращает объект , представляющий дополнительные линии сетки для указанной оси.
getMinorGridlines(): ChartGridlines;
Возвращает
getMinorTickMark()
Указывает тип дополнительной отметки для указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickMark статье.
getMinorTickMark(): ChartAxisTickMark;
Возвращает
getMinorTimeUnitScale()
Указывает дополнительное значение шкалы единицы для оси категорий, если categoryType свойство имеет значение dateAxis.
getMinorTimeUnitScale(): ChartAxisTimeUnit;
Возвращает
getMinorUnit()
Указывает интервал между двумя незначительными отметками.
getMinorUnit(): number;
Возвращает
number
getMultiLevel()
Указывает, является ли ось многоуровневой.
getMultiLevel(): boolean;
Возвращает
boolean
getNumberFormat()
Задает код формата для метки такта оси.
getNumberFormat(): string;
Возвращает
string
getOffset()
Указывает расстояние между уровнями меток и расстояние между первым уровнем и линией оси. Значение должно быть целым числом от 0 до 1000.
getOffset(): number;
Возвращает
number
getPosition()
Указывает указанное положение оси, в котором пересекаются другие оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisPosition статье.
getPosition(): ChartAxisPosition;
Возвращает
getPositionAt()
Указывает положение оси, в которой пересекаются другие оси. Для задания этого свойства следует использовать SetPositionAt(double) метод .
getPositionAt(): number;
Возвращает
number
getReversePlotOrder()
Указывает, отображает ли Excel точки данных от последней до первой.
getReversePlotOrder(): boolean;
Возвращает
boolean
getScaleType()
Указывает тип масштабирования оси значений. Дополнительные сведения см. в этой ExcelScript.ChartAxisScaleType статье.
getScaleType(): ChartAxisScaleType;
Возвращает
getShowDisplayUnitLabel()
Указывает, отображается ли метка единицы отображения оси.
getShowDisplayUnitLabel(): boolean;
Возвращает
boolean
getTextOrientation()
Указывает угол, на который текст ориентирован для метки тика оси диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста.
getTextOrientation(): number;
Возвращает
number
getTickLabelPosition()
Указывает положение меток галочки на указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickLabelPosition статье.
getTickLabelPosition(): ChartAxisTickLabelPosition;
Возвращает
getTickLabelSpacing()
Указывает количество категорий или рядов между метками. Может быть значением от 1 до 31999.
getTickLabelSpacing(): number;
Возвращает
number
getTickMarkSpacing()
Указывает количество категорий или рядов между метками.
getTickMarkSpacing(): number;
Возвращает
number
getTitle()
getTop()
Указывает расстояние (в точках) от верхнего края оси до верхней части области диаграммы. Возвращает значение null , если ось не видна.
getTop(): number;
Возвращает
number
getType()
Указывает тип оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisType статье.
getType(): ChartAxisType;
Возвращает
getVisible()
Указывает, видна ли ось.
getVisible(): boolean;
Возвращает
boolean
getWidth()
Задает ширину (в точках) оси диаграммы. Возвращает значение null , если ось не видна.
getWidth(): number;
Возвращает
number
setAlignment(alignment)
Задает выравнивание для указанной метки тика оси. Дополнительные сведения см. в статье ExcelScript.ChartTextHorizontalAlignment .
setAlignment(alignment: ChartTickLabelAlignment): void;
Параметры
- alignment
- ExcelScript.ChartTickLabelAlignment
Возвращает
void
setBaseTimeUnit(baseTimeUnit)
Указывает базовую единицу для указанной оси категорий.
setBaseTimeUnit(baseTimeUnit: ChartAxisTimeUnit): void;
Параметры
- baseTimeUnit
- ExcelScript.ChartAxisTimeUnit
Возвращает
void
setCategoryNames(sourceData)
Устанавливает все имена категорий для указанной оси.
setCategoryNames(sourceData: Range): void;
Параметры
- sourceData
- ExcelScript.Range
Объект Range , соответствующий исходным данным.
Возвращает
void
setCategoryType(categoryType)
Указывает тип оси категории.
setCategoryType(categoryType: ChartAxisCategoryType): void;
Параметры
- categoryType
- ExcelScript.ChartAxisCategoryType
Возвращает
void
setCustomDisplayUnit(value)
Задает отображаемую единицу измерения оси в виде настраиваемого значения.
setCustomDisplayUnit(value: number): void;
Параметры
- value
-
number
Настраиваемое значение единицы отображения.
Возвращает
void
setDisplayUnit(displayUnit)
Представляет отображаемую единицу измерения оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisDisplayUnit статье.
setDisplayUnit(displayUnit: ChartAxisDisplayUnit): void;
Параметры
- displayUnit
- ExcelScript.ChartAxisDisplayUnit
Возвращает
void
Примеры
/**
* This sample sets the display unit of the value axis to thousands.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the value axis to display in thousands.
chart.getAxes().getValueAxis().setDisplayUnit(ExcelScript.ChartAxisDisplayUnit.thousands);
}
setIsBetweenCategories(isBetweenCategories)
Указывает, пересекает ли ось значений ось категорий между категориями.
setIsBetweenCategories(isBetweenCategories: boolean): void;
Параметры
- isBetweenCategories
-
boolean
Возвращает
void
setLinkNumberFormat(linkNumberFormat)
Указывает, связан ли числовой формат с ячейками. Если trueзадано значение , числовой формат изменится в метках при изменении в ячейках.
setLinkNumberFormat(linkNumberFormat: boolean): void;
Параметры
- linkNumberFormat
-
boolean
Возвращает
void
setLogBase(logBase)
Задает основание логарифма при использовании логарифмических шкал.
setLogBase(logBase: number): void;
Параметры
- logBase
-
number
Возвращает
void
setMajorTickMark(majorTickMark)
Указывает тип основной отметки для указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickMark статье.
setMajorTickMark(majorTickMark: ChartAxisTickMark): void;
Параметры
- majorTickMark
- ExcelScript.ChartAxisTickMark
Возвращает
void
setMajorTimeUnitScale(majorTimeUnitScale)
Задает значение шкалы основной единицы для оси категорий, если свойству categoryType присвоено значение dateAxis.
setMajorTimeUnitScale(majorTimeUnitScale: ChartAxisTimeUnit): void;
Параметры
- majorTimeUnitScale
- ExcelScript.ChartAxisTimeUnit
Возвращает
void
setMajorUnit(majorUnit)
Задает интервал между двумя основными отметками.
setMajorUnit(majorUnit: number): void;
Параметры
- majorUnit
-
number
Возвращает
void
setMaximum(maximum)
Задает максимальное значение на оси значений.
setMaximum(maximum: number): void;
Параметры
- maximum
-
number
Возвращает
void
Примеры
/**
* This sample sets the maximum value on the value axis.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the maximum value to 10.
chart.getAxes().getValueAxis().setMaximum(10);
}
setMinimum(minimum)
Задает минимальное значение на оси значений.
setMinimum(minimum: number): void;
Параметры
- minimum
-
number
Возвращает
void
Примеры
/**
* This sample sets the minimum value on the value axis.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the minimum value to 145.
chart.getAxes().getValueAxis().setMinimum(145);
}
setMinorTickMark(minorTickMark)
Указывает тип дополнительной отметки для указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickMark статье.
setMinorTickMark(minorTickMark: ChartAxisTickMark): void;
Параметры
- minorTickMark
- ExcelScript.ChartAxisTickMark
Возвращает
void
setMinorTimeUnitScale(minorTimeUnitScale)
Указывает дополнительное значение шкалы единицы для оси категорий, если categoryType свойство имеет значение dateAxis.
setMinorTimeUnitScale(minorTimeUnitScale: ChartAxisTimeUnit): void;
Параметры
- minorTimeUnitScale
- ExcelScript.ChartAxisTimeUnit
Возвращает
void
setMinorUnit(minorUnit)
Указывает интервал между двумя незначительными отметками.
setMinorUnit(minorUnit: number): void;
Параметры
- minorUnit
-
number
Возвращает
void
setMultiLevel(multiLevel)
Указывает, является ли ось многоуровневой.
setMultiLevel(multiLevel: boolean): void;
Параметры
- multiLevel
-
boolean
Возвращает
void
setNumberFormat(numberFormat)
Задает код формата для метки такта оси.
setNumberFormat(numberFormat: string): void;
Параметры
- numberFormat
-
string
Возвращает
void
setOffset(offset)
Указывает расстояние между уровнями меток и расстояние между первым уровнем и линией оси. Значение должно быть целым числом от 0 до 1000.
setOffset(offset: number): void;
Параметры
- offset
-
number
Возвращает
void
setPosition(position)
Указывает указанное положение оси, в котором пересекаются другие оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisPosition статье.
setPosition(position: ChartAxisPosition): void;
Параметры
- position
- ExcelScript.ChartAxisPosition
Возвращает
void
setPositionAt(value)
Задает указанное положение оси, в котором пересекаются другие оси.
setPositionAt(value: number): void;
Параметры
- value
-
number
Пользовательское значение точки пересечения.
Возвращает
void
setReversePlotOrder(reversePlotOrder)
Указывает, отображает ли Excel точки данных от последней до первой.
setReversePlotOrder(reversePlotOrder: boolean): void;
Параметры
- reversePlotOrder
-
boolean
Возвращает
void
Примеры
/**
* This sample reverses the plot order of the category axis.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the category axis to reverse the plot order.
chart.getAxes().getCategoryAxis().setReversePlotOrder(true);
}
setScaleType(scaleType)
Указывает тип масштабирования оси значений. Дополнительные сведения см. в этой ExcelScript.ChartAxisScaleType статье.
setScaleType(scaleType: ChartAxisScaleType): void;
Параметры
- scaleType
- ExcelScript.ChartAxisScaleType
Возвращает
void
setShowDisplayUnitLabel(showDisplayUnitLabel)
Указывает, отображается ли метка единицы отображения оси.
setShowDisplayUnitLabel(showDisplayUnitLabel: boolean): void;
Параметры
- showDisplayUnitLabel
-
boolean
Возвращает
void
setTextOrientation(textOrientation)
Указывает угол, на который текст ориентирован для метки тика оси диаграммы. Значение должно быть целым числом от -90 до 90 или целым числом 180 для вертикально ориентированного текста.
setTextOrientation(textOrientation: number): void;
Параметры
- textOrientation
-
number
Возвращает
void
setTickLabelPosition(tickLabelPosition)
Указывает положение меток галочки на указанной оси. Дополнительные сведения см. в этой ExcelScript.ChartAxisTickLabelPosition статье.
setTickLabelPosition(
tickLabelPosition: ChartAxisTickLabelPosition
): void;
Параметры
- tickLabelPosition
- ExcelScript.ChartAxisTickLabelPosition
Возвращает
void
Примеры
/**
* This sample sets the tick label position on the category axis.
* This assumes the active worksheet has a chart.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first chart on the active worksheet.
const sheet = workbook.getActiveWorksheet();
const chart = sheet.getCharts()[0];
// Set the tick label position to low.
chart.getAxes().getCategoryAxis().setTickLabelPosition(
ExcelScript.ChartAxisTickLabelPosition.low
);
}
setTickLabelSpacing(tickLabelSpacing)
Указывает количество категорий или рядов между метками. Может быть значением от 1 до 31999.
setTickLabelSpacing(tickLabelSpacing: number): void;
Параметры
- tickLabelSpacing
-
number
Возвращает
void
setTickMarkSpacing(tickMarkSpacing)
Указывает количество категорий или рядов между метками.
setTickMarkSpacing(tickMarkSpacing: number): void;
Параметры
- tickMarkSpacing
-
number
Возвращает
void
setVisible(visible)
Указывает, видна ли ось.
setVisible(visible: boolean): void;
Параметры
- visible
-
boolean
Возвращает
void