Новые возможности API JavaScript для Excel 1,8What's new in Excel JavaScript API 1.8

Функции набора обязательных элементов API JavaScript для Excel 1.8 включают API для сводных таблиц, проверку данных, диаграммы, события для диаграмм, параметры производительности и создание рабочей книги.The Excel JavaScript API requirement set 1.8 features include APIs for PivotTables, data validation, charts, events for charts, performance options, and workbook creation.

Сводная таблицаPivotTable

Этап 2 для API сводной таблицы позволяет надстройкам устанавливать иерархии сводной таблицы.Wave 2 of the PivotTable APIs lets add-ins set the hierarchies of a PivotTable. Теперь вы можете управлять данными и способом их сведения.You can now control the data and how it is aggregated. Наша статья о сводной таблице содержит дополнительные сведения о новых функциональных возможностях сводной таблицы.Our PivotTable article has more on the new PivotTable functionality.

Проверка данныхData Validation

Проверка данных позволяет управлять данными, которые вводит в лист пользователь.Data validation gives you control of what a user enters in a worksheet. Вы можете ограничить ячейки предопределенными наборами ответов или задать всплывающие предупреждения о нежелательном вводе.You can limit cells to pre-defined answer sets or give pop-up warnings about undesirable input. Узнайте больше о добавлении проверки данных в диапазоны уже сегодня.Learn more about adding data validation to ranges today.

ДиаграммыCharts

Еще один этап выпуска API диаграмм обеспечивает дополнительный программный контроль над элементами диаграммы.Another round of Chart APIs brings even greater programmatic control over chart elements. Теперь у вас есть расширенный доступ к условным обозначениям, осям, линии тренда и области построения.You now have greater access to the legend, axes, trendline, and plot area.

СобытияEvents

Для диаграмм добавлены дополнительные события.More events have been added for charts. Пусть ваша надстройка реагирует на взаимодействие пользователей с диаграммой.Have your add-in react to users interacting with the chart. Вы также можете включать и отключать события, запускаемые во всей книге.You can also toggle events firing across the entire workbook.

Список APIAPI list

В следующей таблице перечислены API в наборе обязательных элементов API JavaScript для Excel 1,8.The following table lists the APIs in Excel JavaScript API requirement set 1.8. Чтобы просмотреть справочную документацию по API для всех API, поддерживаемых набором обязательных элементов API JavaScript для Excel 1,8 или более ранней версии, обратитесь к разделам API Excel в наборе требований 1,8To view API reference documentation for all APIs supported by Excel JavaScript API requirement set 1.8 or earlier, see Excel APIs in requirement set 1.8 or earlier.

КлассClass ПоляFields ОписаниеDescription
БасикдатавалидатионBasicDataValidation Formula1formula1 Задает правый операнд, если для свойства operator задан бинарный оператор, такой как GreaterThan (левый операнд — это значение, которое пользователь пытается ввести в ячейку).Specifies the right-hand operand when the operator property is set to a binary operator such as GreaterThan (the left-hand operand is the value the user tries to enter in the cell). С помощью операторов тернарного между и Нотбетвин задает нижнюю границу операнда.With the ternary operators Between and NotBetween, specifies the lower bound operand.
formula2formula2 С помощью операторов тернарного между и Нотбетвин указывает верхнюю границу операнда.With the ternary operators Between and NotBetween, specifies the upper bound operand. Не используется с двоичными операторами, например GreaterThan.Is not used with the binary operators, such as GreaterThan.
oroperator Оператор, используемый для проверки данных.The operator to use for validating the data.
ChartChart categoryLabelLevelcategoryLabelLevel Возвращает или задает константу перечисления Чарткатегорилабеллевел, ссылающуюся наReturns or sets a ChartCategoryLabelLevel enumeration constant referring to
displayBlanksAsdisplayBlanksAs Возвращает или задает способ отображения пустых ячеек на диаграмме.Returns or sets the way that blank cells are plotted on a chart. Для чтения и записи.Read/Write.
plotByplotBy Возвращает или задает способ использования столбцов или строк в качестве рядов данных на диаграмме.Returns or sets the way columns or rows are used as data series on the chart. Для чтения и записи.Read/Write.
plotVisibleOnlyplotVisibleOnly True, если отображаются только видимые ячейки.True if only visible cells are plotted.False, если отображаются как видимые, так и скрытые ячейки. False if both visible and hidden cells are plotted. Для чтения и записи.Read/Write.
onActivatedonActivated Возникает при активации диаграммы.Occurs when the chart is activated.
onDeactivatedonDeactivated Возникает при отключении диаграммы.Occurs when the chart is deactivated.
plotAreaplotArea Представляет plotArea для диаграммы.Represents the plotArea for the chart.
seriesNameLevelseriesNameLevel Возвращает или задает константу перечисления Чартсериеснамелевел, ссылающуюся наReturns or sets a ChartSeriesNameLevel enumeration constant referring to
showDataLabelsOverMaximumshowDataLabelsOverMaximum Представляет, нужно ли отображать метки данных, если значение больше максимального на оси значений.Represents whether to show the data labels when the value is greater than the maximum value on the value axis.
stylestyle Возвращает или задает стиль для диаграммы.Returns or sets the chart style for the chart. Для чтения и записи.Read/Write.
ЧартактиватедевентаргсChartActivatedEventArgs ЧартидchartId Получает идентификатор активированной диаграммы.Gets the id of the chart that is activated.
typetype Получает тип события.Gets the type of the event. Дополнительные сведения см. в статье Excel.EventType.See Excel.EventType for details.
worksheetIdworksheetId Получает идентификатор листа, в котором активирована диаграмма.Gets the id of the worksheet in which the chart is activated.
ЧартаддедевентаргсChartAddedEventArgs ЧартидchartId Получает идентификатор диаграммы, добавленной в лист.Gets the id of the chart that is added to the worksheet.
sourcesource Получает источник события.Gets the source of the event. Дополнительные сведения см. в статье Excel.EventSource.See Excel.EventSource for details.
typetype Получает тип события.Gets the type of the event. Дополнительные сведения см. в статье Excel.EventType.See Excel.EventType for details.
worksheetIdworksheetId Получает идентификатор листа, в который добавлена диаграмма.Gets the id of the worksheet in which the chart is added.
ChartAxisChartAxis ориентацииalignment Представляет выравнивание для указанной метки делений оси.Represents the alignment for the specified axis tick label. Дополнительные сведения см. в статье Excel. Чарттекссоризонталалигнмент.See Excel.ChartTextHorizontalAlignment for detail.
ИсбетвинкатегориесisBetweenCategories Указывает, пересекает ли ось значений ось категорий между категориями.Represents whether value axis crosses the category axis between categories.
УровневыеmultiLevel Указывает, является ли ось многоуровневой или нет.Represents whether an axis is multilevel or not.
numberFormatnumberFormat Представляет код формата для метки делений оси.Represents the format code for the axis tick label.
корреспондирующей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.
positionposition Представляет указанное положение оси в месте, где ее пересекает другая ось.Represents the specified axis position where the other axis crosses. Дополнительные сведения см. в статье Excel. Чартаксиспоситион.See Excel.ChartAxisPosition for details.
Поситионат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.
Сетпоситионат (значение: число)setPositionAt(value: number) Задает указанное положение оси в месте, где ее пересекает другая ось.Set the specified axis position where the other axis crosses at.
textOrientationtextOrientation Представляет ориентацию текста для метки делений оси.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.
ChartAxisFormatChartAxisFormat fillfill Представляет форматирование заливки диаграммы.Represents chart fill formatting. Только для чтения.Read-only.
ChartAxisTitleChartAxisTitle Сетформула (формула: строка)setFormula(formula: string) Строковое значение, представляющее формулу заголовка оси диаграммы с использованием нотации стиля A1.A string value that represents the formula of chart axis title using A1-style notation.
ChartAxisTitleFormatChartAxisTitleFormat вокругborder Представляет формат границы, включающий цвет, тип линии и толщину.Represents the border format, which includes color, linestyle, and weight.
fillfill Представляет форматирование заливки диаграммы.Represents chart fill formatting.
ChartBorderChartBorder clear()clear() Очищает формат границы элемента диаграммы.Clear the border format of a chart element.
ChartCollectionChartCollection onActivatedonActivated Возникает при активации диаграммы.Occurs when a chart is activated.
onAddedonAdded Возникает при добавлении новой диаграммы на лист.Occurs when a new chart is added to the worksheet.
onDeactivatedonDeactivated Возникает при отключении диаграммы.Occurs when a chart is deactivated.
onDeletedonDeleted Возникает при удалении диаграммы.Occurs when a chart is deleted.
ChartDataLabelChartDataLabel ЭлементаautoText Логическое значение, указывающее на то, генерирует ли метка данных автоматически соответствующий текст на основе контекста.Boolean value representing if data label automatically generates appropriate text based on context.
formulaformula Строковое значение, представляющее формулу метки данных диаграммы с использованием нотации стиля A1.String value that represents the formula of chart data label using A1-style notation.
horizontalAlignmenthorizontalAlignment Представляет горизонтальное выравнивание для метки данных диаграммы.Represents the horizontal alignment for chart data label. Дополнительные сведения см. в статье Excel. Чарттекссоризонталалигнмент.See Excel.ChartTextHorizontalAlignment for details.
leftleft Представляет расстояние от левого края метки данных диаграммы до левого края области диаграммы (в пунктах). Represents the distance, in points, from the left edge of chart data label to the left edge of chart area. Значение NULL, если метка данных диаграммы не отображается.Null if chart data label is not visible.
numberFormatnumberFormat Строковое значение, представляющее код формата для метки данных.String value that represents the format code for data label.
formatformat Представляет формат метки данных диаграммы.Represents the format of chart data label.
heightheight Возвращает высоту метки данных диаграммы (в пунктах).Returns the height, in points, of the chart data label. Только для чтения.Read-only. Значение NULL, если метка данных диаграммы не отображается.Null if chart data label is not visible.
widthwidth Возвращает ширину метки данных диаграммы (в пунктах).Returns the width, in points, of the chart data label. Только для чтения.Read-only. Значение NULL, если метка данных диаграммы не отображается.Null if chart data label is not visible.
texttext Строка, представляющая текст метки данных на диаграмме.String representing the text of the data label on a chart.
textOrientationtextOrientation Представляет ориентацию текста для метки данных диаграммы.Represents the text orientation of chart data label. Значение должно быть целым числом от -90 до 90 или 180 для вертикально-ориентированного текста.The value should be an integer either from -90 to 90, or 180 for vertically-oriented text.
toptop Представляет расстояние от верхнего края метки данных диаграммы до верха области диаграммы (в пунктах).Represents the distance, in points, from the top edge of chart data label to the top of chart area. Значение NULL, если метка данных диаграммы не отображается.Null if chart data label is not visible.
verticalAlignmentverticalAlignment Представляет вертикальное выравнивание для метки данных диаграммы.Represents the vertical alignment of chart data label. Дополнительные сведения см. в статье Excel. Чарттекствертикалалигнмент.See Excel.ChartTextVerticalAlignment for details.
ChartDataLabelFormatChartDataLabelFormat вокругborder Представляет формат границы, включающий цвет, тип линии и толщину.Represents the border format, which includes color, linestyle, and weight. Только для чтения.Read-only.
ChartDataLabelsChartDataLabels ЭлементаautoText Указывает, генерируют ли метки данных автоматически соответствующий текст на основе контекста.Represents whether data labels automatically generate appropriate text based on context.
horizontalAlignmenthorizontalAlignment Представляет горизонтальное выравнивание для метки данных диаграммы.Represents the horizontal alignment for chart data label. Дополнительные сведения см. в статье Excel. Чарттекссоризонталалигнмент.See Excel.ChartTextHorizontalAlignment for details.
numberFormatnumberFormat Представляет код формата для меток данных.Represents the format code for data labels.
textOrientationtextOrientation Представляет ориентацию текста для меток данных.Represents the text orientation of data labels. Значение должно быть целым числом от -90 до 90 или 180 для вертикально-ориентированного текста.The value should be an integer either from -90 to 90, or 180 for vertically-oriented text.
verticalAlignmentverticalAlignment Представляет вертикальное выравнивание для метки данных диаграммы.Represents the vertical alignment of chart data label. Дополнительные сведения см. в статье Excel. Чарттекствертикалалигнмент.See Excel.ChartTextVerticalAlignment for details.
ЧартдеактиватедевентаргсChartDeactivatedEventArgs ЧартидchartId Получает идентификатор деактивированной диаграммы.Gets the id of the chart that is deactivated.
typetype Получает тип события.Gets the type of the event. Дополнительные сведения см. в статье Excel.EventType.See Excel.EventType for details.
worksheetIdworksheetId Получает идентификатор листа, в котором деактивирована диаграмма.Gets the id of the worksheet in which the chart is deactivated.
ЧартделетедевентаргсChartDeletedEventArgs ЧартидchartId Получает идентификатор диаграммы, удаляемой с листа.Gets the id of the chart that is deleted from the worksheet.
sourcesource Получает источник события.Gets the source of the event. Дополнительные сведения см. в статье Excel.EventSource.See Excel.EventSource for details.
typetype Получает тип события.Gets the type of the event. Дополнительные сведения см. в статье Excel.EventType.See Excel.EventType for details.
worksheetIdworksheetId Получает идентификатор листа, в котором удаляется диаграмма.Gets the id of the worksheet in which the chart is deleted.
ЧартлежендентриChartLegendEntry heightheight Представляет высоту объекта legendEntry в условных обозначениях диаграммы.Represents the height of the legendEntry on the chart legend.
индексindex Представляет индекс объекта legendEntry в условных обозначениях диаграммы.Represents the index of the legendEntry in the chart legend.
leftleft Представляет левую часть объекта legendEntry диаграммы.Represents the left of a chart legendEntry.
toptop Представляет верхнюю часть объекта legendEntry диаграммы.Represents the top of a chart legendEntry.
widthwidth Представляет ширину объекта legendEntry в условных обозначениях диаграммы.Represents the width of the legendEntry on the chart Legend.
ChartLegendFormatChartLegendFormat вокругborder Представляет формат границы, включающий цвет, тип линии и толщину.Represents the border format, which includes color, linestyle, and weight. Только для чтения.Read-only.
ЧартплотареаChartPlotArea heightheight Представляет значение высоты plotArea.Represents the height value of plotArea.
insideHeightinsideHeight Представляет значение insideHeight для plotArea.Represents the insideHeight value of plotArea.
insideLeftinsideLeft Представляет значение insideLeft для plotArea.Represents the insideLeft value of plotArea.
insideTopinsideTop Представляет значение insideTop для plotArea.Represents the insideTop value of plotArea.
insideWidthinsideWidth Представляет значение insideWidth для plotArea.Represents the insideWidth value of plotArea.
leftleft Представляет левое значение plotArea.Represents the left value of plotArea.
positionposition Представляет положение plotArea.Represents the position of plotArea.
formatformat Представляет форматирование для plotArea диаграммы.Represents the formatting of a chart plotArea.
toptop Представляет верхнее значение plotArea.Represents the top value of plotArea.
widthwidth Представляет значение ширины plotArea.Represents the width value of plotArea.
ЧартплотареаформатChartPlotAreaFormat вокругborder Представляет атрибуты границы для plotArea диаграммы.Represents the border attributes of a chart plotArea.
fillfill Представляет формат заливки объекта, включая сведения о форматировании фона.Represents the fill format of an object, which includes background formatting information.
ChartSeriesChartSeries axisGroupaxisGroup Возвращает или задает группу для указанного ряда.Returns or sets the group for the specified series. Чтение и записьRead/Write
развертываниexplosion Возвращает или задает значение развертывания для сектора круговой или кольцевой диаграммы.Returns or sets the explosion value for a pie-chart or doughnut-chart slice. Возвращает нуль (0) при отсутствии развертывания (верхушка сектора — в центре круговой диаграммы).Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie). Для чтения и записи.Read/Write.
firstSliceAnglefirstSliceAngle Возвращает или задает угол первого сектора круговой или кольцевой диаграммы, в градусах (по часовой стрелке из вертикального положения).Returns or sets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Применяется только к круговым, объемным круговым и кольцевым диаграммам.Applies only to pie, 3-D pie, and doughnut charts. Может находиться в диапазоне от 0 до 360.Can be a value from 0 through 360. Чтение и записьRead/Write
invertIfNegativeinvertIfNegative Значение true, если Microsoft Excel инвертирует шаблон в элементе, когда он соответствует отрицательному числу.True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number. Для чтения и записи.Read/Write.
перекрывающеесяoverlap Указывает на расположение строк и столбцов.Specifies how bars and columns are positioned. Может принимать значение от – 100 до 100.Can be a value between –100 and 100. Применяется только к двумерным диаграммам и гистограммам.Applies only to 2-D bar and 2-D column charts. Для чтения и записи.Read/Write.
dataLabelsdataLabels Представляет коллекцию всех dataLabels в ряду.Represents a collection of all dataLabels in the series.
secondPlotSizesecondPlotSize Возвращает или задает размер вторичного раздела круга круговой диаграммы либо линии круговой диаграммы в процентах от размера основной круговой диаграммы.Returns or sets the size of the secondary section of either a pie of pie chart or a bar of pie chart, as a percentage of the size of the primary pie. Может находиться в диапазоне от 5 до 200.Can be a value from 5 to 200. Для чтения и записи.Read/Write.
splitTypesplitType Возвращает или задает способ разделения двух разделов круга круговой диаграммы либо линии круговой диаграммы.Returns or sets the way the two sections of either a pie of pie chart or a bar of pie chart are split. Для чтения и записи.Read/Write.
varyByCategoriesvaryByCategories Значение true, если Microsoft Excel назначает разные цвета или шаблоны каждому маркеру данных.True if Microsoft Excel assigns a different color or pattern to each data marker. Диаграмма должна содержать только один ряд.The chart must contain only one series. Для чтения и записи.Read/Write.
ЧарттрендлинеChartTrendline БакквардпериодbackwardPeriod Представляет число периодов, на которые линия тренда расширяется назад.Represents the number of periods that the trendline extends backward.
ФорвардпериодforwardPeriod Представляет число периодов, на которые линия тренда расширяется вперед.Represents the number of periods that the trendline extends forward.
Клейlabel Представляет метку линии тренда диаграммы.Represents the label of a chart trendline.
ШовекуатионshowEquation Значение true, если формула для линии тренда отображается на диаграмме.True if the equation for the trendline is displayed on the chart.
ШоврскуаредshowRSquared Значение true, если величина достоверности аппроксимации для линии тренда отображается на диаграмме.True if the R-squared for the trendline is displayed on the chart.
ChartTrendlineLabelChartTrendlineLabel ЭлементаautoText Логическое значение, указывающее на то, генерирует ли метка линии тренда автоматически соответствующий текст на основе контекста.Boolean value representing if trendline label automatically generates appropriate text based on context.
formulaformula Строковое значение, представляющее формулу подписи линии тренда диаграммы с использованием нотации стиля A1.String value that represents the formula of chart trendline label using A1-style notation.
horizontalAlignmenthorizontalAlignment Представляет горизонтальное выравнивание для подписи линии тренда диаграммы.Represents the horizontal alignment for chart trendline label. Дополнительные сведения см. в статье Excel. Чарттекссоризонталалигнмент.See Excel.ChartTextHorizontalAlignment for details.
leftleft Представляет расстояние от левого края подписи линии тренда диаграммы до левого края области диаграммы (в пунктах).Represents the distance, in points, from the left edge of chart trendline label to the left edge of chart area. Значение NULL, если подпись линии тренда диаграммы не отображается.Null if chart trendline label is not visible.
numberFormatnumberFormat Строковое значение, представляющее код формата для подписи линии тренда.String value that represents the format code for trendline label.
formatformat Представляет формат подписи линии тренда диаграммы.Represents the format of chart trendline label.
heightheight Возвращает высоту подписи линии тренда диаграммы (в пунктах).Returns the height, in points, of the chart trendline label. Только для чтения.Read-only. Значение NULL, если подпись линии тренда диаграммы не отображается.Null if chart trendline label is not visible.
widthwidth Возвращает ширину подписи линии тренда диаграммы (в пунктах).Returns the width, in points, of the chart trendline label. Только для чтения.Read-only. Значение NULL, если подпись линии тренда диаграммы не отображается.Null if chart trendline label is not visible.
texttext Строка, представляющая текст подписи линии тренда на диаграмме.String representing the text of the trendline label on a chart.
textOrientationtextOrientation Представляет ориентацию текста для подписи линии тренда диаграммы.Represents the text orientation of chart trendline label. Значение должно быть целым числом от -90 до 90 или 180 для вертикально-ориентированного текста.The value should be an integer either from -90 to 90, or 180 for vertically-oriented text.
toptop Представляет расстояние от верхнего края подписи линии тренда диаграммы до верха области диаграммы (в пунктах).Represents the distance, in points, from the top edge of chart trendline label to the top of chart area. Значение NULL, если подпись линии тренда диаграммы не отображается.Null if chart trendline label is not visible.
verticalAlignmentverticalAlignment Представляет вертикальное выравнивание для подписи линии тренда диаграммы.Represents the vertical alignment of chart trendline label. Дополнительные сведения см. в статье Excel. Чарттекствертикалалигнмент.See Excel.ChartTextVerticalAlignment for details.
ЧарттрендлинелабелформатChartTrendlineLabelFormat вокругborder Представляет формат границы, включающий цвет, тип линии и толщину.Represents the border format, which includes color, linestyle, and weight.
fillfill Представляет формат заливки для текущей подписи линии тренда диаграммы.Represents the fill format of the current chart trendline label.
fontfont Представляет атрибуты шрифта (имя, размер, цвет и т. д.) для подписи линии тренда диаграммы.Represents the font attributes (font name, font size, color, etc.) for a chart trendline label.
КустомдатавалидатионCustomDataValidation formulaformula Формула проверки настраиваемых данных.A custom data validation formula. При этом создаются специальные правила ввода, такие как предотвращение дублирования или ограничение суммы в диапазоне ячеек.This creates special input rules, such as preventing duplicates, or limiting the total in a range of cells.
DataPivotHierarchyDataPivotHierarchy namename Имя DataPivotHierarchy.Name of the DataPivotHierarchy.
numberFormatnumberFormat Числовой формат DataPivotHierarchy.Number format of the DataPivotHierarchy.
positionposition Положение DataPivotHierarchy.Position of the DataPivotHierarchy.
полеfield Возвращает сводные поля, связанные с DataPivotHierarchy.Returns the PivotFields associated with the DataPivotHierarchy.
idid Идентификатор DataPivotHierarchy.Id of the DataPivotHierarchy.
Сеттодефаулт ()setToDefault() Сбрасывает DataPivotHierarchy до значений по умолчанию.Reset the DataPivotHierarchy back to its default values.
showAsshowAs Определяет, должны ли данные отображаться как конкретные суммарные вычисления или нет.Determines whether the data should be shown as a specific summary calculation or not.
summarizeBysummarizeBy Определяет, следует ли отображать все элементы DataPivotHierarchy.Determines whether to show all items of the DataPivotHierarchy.
ДатапивосиерарчиколлектионDataPivotHierarchyCollection Add (pivotHierarchy: Excel. PivotHierarchy)add(pivotHierarchy: Excel.PivotHierarchy) Добавляет PivotHierarchy к текущей оси.Adds the PivotHierarchy to the current axis.
getCount()getCount() Получает количество иерархий сводного объекта в коллекции.Gets the number of pivot hierarchies in the collection.
getItem(name: string)getItem(name: string) Получает DataPivotHierarchy по имени или идентификатору.Gets a DataPivotHierarchy by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает DataPivotHierarchy по имени.Gets a DataPivotHierarchy by name. Если DataPivotHierarchy не существует, возвращает пустой объект.If the DataPivotHierarchy does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
Remove (DataPivotHierarchy: Excel. DataPivotHierarchy)remove(DataPivotHierarchy: Excel.DataPivotHierarchy) Удаляет PivotHierarchy из текущей оси.Removes the PivotHierarchy from the current axis.
DataValidationDataValidation clear()clear() Очищает проверку данных из текущего диапазона.Clears the data validation from the current range.
ЕрроралертerrorAlert Сообщение об ошибке, когда пользователь вводит недопустимые данные.Error alert when user enters invalid data.
ИгноребланксignoreBlanks Игнорировать пустые ячейки: проверка данных не будет выполняться в пустых ячейках, по умолчанию используется значение true.Ignore blanks: no data validation will be performed on blank cells, it defaults to true.
сообщениеprompt Выдавать запрос при выборе пользователем ячейки.Prompt when users select a cell.
typetype Тип проверки данных, подробные сведения см. в статье Excel.DataValidationType.Type of the data validation, see Excel.DataValidationType for details.
верноvalid Указывает, являются ли все значения ячеек допустимыми в соответствии с правилами проверки данных.Represents if all cell values are valid according to the data validation rules.
правилаrule Правило проверки данных, которое содержит различные типы условий проверки данных.Data validation rule that contains different type of data validation criteria.
ДатавалидатионерроралертDataValidationErrorAlert messagemessage Представляет предупреждающее сообщение об ошибке.Represents error alert message.
ШовалертshowAlert Определяет, показывать ли диалоговое окно с предупреждением об ошибке или нет, если пользователь вводит неверные данные.Determines whether to show an error alert dialog or not when a user enters invalid data. Значение по умолчанию: true.The default is true.
stylestyle Представляет тип предупреждения проверки данных, подробные сведения см. в статье Excel.DataValidationAlertStyle.Represents data validation alert type, please see Excel.DataValidationAlertStyle for details.
заголовокtitle Представляет заголовок диалогового окна предупреждения об ошибке.Represents error alert dialog title.
ДатавалидатионпромптDataValidationPrompt messagemessage Представляет сообщение подсказки.Represents the message of the prompt.
ШовпромптshowPrompt Определяет, показывать ли подсказку, когда пользователь выбирает ячейку с проверкой данных.Determines whether or not to show the prompt when user selects a cell with data validation.
заголовокtitle Представляет заголовок подсказки.Represents the title for the prompt.
ДатавалидатионрулеDataValidationRule собственныйcustom Условия проверки настраиваемых данных.Custom data validation criteria.
датаdate Условия проверки данных даты.Date data validation criteria.
числеdecimal Условия проверки десятичных данных.Decimal data validation criteria.
listlist Условия проверки данных списка.List data validation criteria.
textLengthtextLength Условия проверки данных TextLength.TextLength data validation criteria.
timetime Условия проверки данных времени.Time data validation criteria.
wholeNumberwholeNumber Условия проверки данных WholeNumber.WholeNumber data validation criteria.
ДатетимедатавалидатионDateTimeDataValidation Formula1formula1 Задает правый операнд, если для свойства operator задан бинарный оператор, такой как GreaterThan (левый операнд — это значение, которое пользователь пытается ввести в ячейку).Specifies the right-hand operand when the operator property is set to a binary operator such as GreaterThan (the left-hand operand is the value the user tries to enter in the cell). С помощью операторов тернарного между и Нотбетвин задает нижнюю границу операнда.With the ternary operators Between and NotBetween, specifies the lower bound operand.
formula2formula2 С помощью операторов тернарного между и Нотбетвин указывает верхнюю границу операнда.With the ternary operators Between and NotBetween, specifies the upper bound operand. Не используется с двоичными операторами, например GreaterThan.Is not used with the binary operators, such as GreaterThan.
oroperator Оператор, используемый для проверки данных.The operator to use for validating the data.
FilterPivotHierarchyFilterPivotHierarchy ЕнаблемултиплефилтеритемсenableMultipleFilterItems Определяет, следует ли разрешить несколько элементов фильтра.Determines whether to allow multiple filter items.
namename Имя FilterPivotHierarchy.Name of the FilterPivotHierarchy.
positionposition Положение FilterPivotHierarchy.Position of the FilterPivotHierarchy.
fieldsfields Возвращает сводные поля, связанные с FilterPivotHierarchy.Returns the PivotFields associated with the FilterPivotHierarchy.
idid Идентификатор FilterPivotHierarchy.Id of the FilterPivotHierarchy.
Сеттодефаулт ()setToDefault() Сбрасывает FilterPivotHierarchy до значений по умолчанию.Reset the FilterPivotHierarchy back to its default values.
ФилтерпивосиерарчиколлектионFilterPivotHierarchyCollection Add (pivotHierarchy: Excel. PivotHierarchy)add(pivotHierarchy: Excel.PivotHierarchy) Добавляет PivotHierarchy к текущей оси.Adds the PivotHierarchy to the current axis. Если иерархия присутствует в другом месте строки, столбца,If the hierarchy is present elsewhere on the row, column,
getCount()getCount() Получает количество иерархий сводного объекта в коллекции.Gets the number of pivot hierarchies in the collection.
getItem(name: string)getItem(name: string) Получает FilterPivotHierarchy по имени или идентификатору.Gets a FilterPivotHierarchy by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает FilterPivotHierarchy по имени.Gets a FilterPivotHierarchy by name. Если FilterPivotHierarchy не существует, возвращает пустой объект.If the FilterPivotHierarchy does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
Remove (filterPivotHierarchy: Excel. FilterPivotHierarchy)remove(filterPivotHierarchy: Excel.FilterPivotHierarchy) Удаляет PivotHierarchy из текущей оси.Removes the PivotHierarchy from the current axis.
ListDataValidationListDataValidation inCellDropDowninCellDropDown Отображает или не отображает список в раскрывающемся меню ячейки, по умолчанию используется значение true.Displays the list in cell drop down or not, it defaults to true.
sourcesource Источник списка для проверки данныхSource of the list for data validation
PivotFieldPivotField namename Имя сводного поля.Name of the PivotField.
idid Идентификатор сводного поля.Id of the PivotField.
itemsitems Возвращает PivotItems, состоящий из PivotField.Returns the PivotItems that comprise with the PivotField.
showAllItemsshowAllItems Определяет, следует ли отображать все элементы сводного поля.Determines whether to show all items of the PivotField.
Сортбилабелс (sortBy: SortBy)sortByLabels(sortBy: SortBy) Сортирует сводное поле.Sorts the PivotField. Если указан параметр DataPivotHierarchy, то сортировка будет применяться на его основе, в ином случае сортировка будет основана на самом сводном поле.If a DataPivotHierarchy is specified, then sort will be applied based on it, if not sort will be based on the PivotField itself.
subtotalssubtotals Промежуточные итоги сводного поля.Subtotals of the PivotField.
ПивотфиелдколлектионPivotFieldCollection getCount()getCount() Получает количество полей Pivot в коллекции.Gets the number of pivot fields in the collection.
getItem(name: string)getItem(name: string) Получает объект PivotField по имени или идентификатору.Gets a PivotField by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает PivotField по имени.Gets a PivotField by name. Если PivotField не существует, вернет пустой объект.If the PivotField does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
PivotHierarchyPivotHierarchy namename Имя PivotHierarchy.Name of the PivotHierarchy.
fieldsfields Возвращает сводные поля, связанные с PivotHierarchy.Returns the PivotFields associated with the PivotHierarchy.
idid Идентификатор PivotHierarchy.Id of the PivotHierarchy.
ПивосиерарчиколлектионPivotHierarchyCollection getCount()getCount() Получает количество иерархий сводного объекта в коллекции.Gets the number of pivot hierarchies in the collection.
getItem(name: string)getItem(name: string) Получает PivotHierarchy по имени или идентификатору.Gets a PivotHierarchy by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает PivotHierarchy по имени.Gets a PivotHierarchy by name. Если PivotHierarchy не существует, возвращает пустой объект.If the PivotHierarchy does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
PivotItemPivotItem isExpandedisExpanded Определяет, развернут ли элемент для отображения дочерних элементов или же свернут, а дочерние элементы являются скрытыми.Determines whether the item is expanded to show child items or if it's collapsed and child items are hidden.
namename Имя элемента сводной таблицы.Name of the PivotItem.
idid Идентификатор элемента сводной таблицы.Id of the PivotItem.
visiblevisible Определяет, отображается ли элемент сводной таблицы или нет.Determines whether the PivotItem is visible or not.
ПивотитемколлектионPivotItemCollection getCount()getCount() Получает количество элементов Pivot в коллекции.Gets the number of pivot items in the collection.
getItem(name: string)getItem(name: string) Получает объект PivotItem по имени или идентификатору.Gets a PivotItem by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает PivotItem по имени.Gets a PivotItem by name. Если PivotItem не существует, вернет пустой объект.If the PivotItem does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
PivotLayoutPivotLayout Жетколумнлабелранже ()getColumnLabelRange() Возвращает диапазон, где находятся названия столбцов сводной таблицы.Returns the range where the PivotTable's column labels reside.
Жетдатабодиранже ()getDataBodyRange() Возвращает диапазон, где находятся значения данных сводной таблицы.Returns the range where the PivotTable's data values reside.
Жетфилтераксисранже ()getFilterAxisRange() Возвращает диапазон области фильтра сводной таблицы.Returns the range of the PivotTable's filter area.
getRange()getRange() Возвращает диапазон, в котором существует сводная таблица, за исключением области фильтра.Returns the range the PivotTable exists on, excluding the filter area.
Жетровлабелранже ()getRowLabelRange() Возвращает диапазон, где находятся названия строк сводной таблицы.Returns the range where the PivotTable's row labels reside.
ЛайауттипеlayoutType Это свойство указывает PivotLayoutType всех полей в сводной таблице.This property indicates the PivotLayoutType of all fields on the PivotTable. Если поля имеют различные состояния, оно будет иметь значение NULL.If fields have different states, this will be null.
ШовколумнграндтоталсshowColumnGrandTotals Указывает, отображаются ли в отчете сводной таблицы общие итоги для столбцов.Specifies whether the PivotTable report shows grand totals for columns.
ШовровграндтоталсshowRowGrandTotals Указывает, отображаются ли в отчете сводной таблицы общие итоги для строк.Specifies whether the PivotTable report shows grand totals for rows.
subtotalLocationsubtotalLocation Это свойство указывает SubtotalLocationType всех полей в сводной таблице.This property indicates the SubtotalLocationType of all fields on the PivotTable. Если поля имеют различные состояния, оно будет иметь значение NULL.If fields have different states, this will be null.
PivotTablePivotTable delete()delete() Удаляет сводную таблицу.Deletes the PivotTable.
КолумнхиерарчиесcolumnHierarchies Иерархии сводных столбцов сводной таблицы.The Column Pivot Hierarchies of the PivotTable.
ИерархииdataHierarchies Иерархии сводных данных сводной таблицы.The Data Pivot Hierarchies of the PivotTable.
ФилтерхиерарчиесfilterHierarchies Иерархии сводных фильтров сводной таблицы.The Filter Pivot Hierarchies of the PivotTable.
иерархииhierarchies Иерархии сводного документа сводной таблицы.The Pivot Hierarchies of the PivotTable.
макетlayout PivotLayout, описывающий макет и визуальную структуру сводной таблицы.The PivotLayout describing the layout and visual structure of the PivotTable.
РовхиерарчиесrowHierarchies Иерархии сводных строк сводной таблицы.The Row Pivot Hierarchies of the PivotTable.
PivotTableCollectionPivotTableCollection Add (имя: строка, источник: таблица | строк | диапазона, назначение: строка | диапазона)add(name: string, source: Range | string | Table, destination: Range | string) Добавление сводной таблицы на основе указанных исходных данных и вставка ее в верхнюю левую ячейку конечного диапазона.Add a Pivottable based on the specified source data and insert it at the top left cell of the destination range.
RangeRange dataValidationdataValidation Возвращает объект проверки данных.Returns a data validation object.
RowColumnPivotHierarchyRowColumnPivotHierarchy namename Имя RowColumnPivotHierarchy.Name of the RowColumnPivotHierarchy.
positionposition Положение RowColumnPivotHierarchy.Position of the RowColumnPivotHierarchy.
fieldsfields Возвращает сводные поля, связанные с RowColumnPivotHierarchy.Returns the PivotFields associated with the RowColumnPivotHierarchy.
idid Идентификатор RowColumnPivotHierarchy.Id of the RowColumnPivotHierarchy.
Сеттодефаулт ()setToDefault() Сбрасывает RowColumnPivotHierarchy до значений по умолчанию.Reset the RowColumnPivotHierarchy back to its default values.
РовколумнпивосиерарчиколлектионRowColumnPivotHierarchyCollection Add (pivotHierarchy: Excel. PivotHierarchy)add(pivotHierarchy: Excel.PivotHierarchy) Добавляет PivotHierarchy к текущей оси.Adds the PivotHierarchy to the current axis. Если иерархия присутствует в другом месте строки, столбца,If the hierarchy is present elsewhere on the row, column,
getCount()getCount() Получает количество иерархий сводного объекта в коллекции.Gets the number of pivot hierarchies in the collection.
getItem(name: string)getItem(name: string) Получает RowColumnPivotHierarchy по имени или идентификатору.Gets a RowColumnPivotHierarchy by its name or id.
getItemOrNullObject(имя: строка)getItemOrNullObject(name: string) Получает RowColumnPivotHierarchy по имени.Gets a RowColumnPivotHierarchy by name. Если RowColumnPivotHierarchy не существует, возвращает пустой объект.If the RowColumnPivotHierarchy does not exist, will return a null object.
itemsitems Получает загруженные дочерние элементы в этой коллекции.Gets the loaded child items in this collection.
Remove (rowColumnPivotHierarchy: Excel. RowColumnPivotHierarchy)remove(rowColumnPivotHierarchy: Excel.RowColumnPivotHierarchy) Удаляет PivotHierarchy из текущей оси.Removes the PivotHierarchy from the current axis.
ПолняющегоRuntime enableEventsenableEvents Включение событий JavaScript в текущей области задач или контентной надстройке.Toggle JavaScript events in the current task pane or content add-in.
ШовасрулеShowAsRule baseFieldbaseField Базовое сводное поле для обоснования расчета ShowAs, если применимо на основе типа ShowAsCalculation, в противном случае значение будет пустым.The base PivotField to base the ShowAs calculation, if applicable based on the ShowAsCalculation type, else null.
baseItembaseItem Базовый элемент для обоснования расчета ShowAs, если применимо на основе типа ShowAsCalculation, в противном случае значение будет пустым.The base Item to base the ShowAs calculation on, if applicable based on the ShowAsCalculation type, else null.
пересчетcalculation Расчет ShowAs для использования в сводном поле данных.The ShowAs Calculation to use for the Data PivotField. Дополнительные сведения см. в статье Excel. ShowAsCalculation.See Excel.ShowAsCalculation for Details.
StyleStyle autoIndentautoIndent Указывает, будет ли выполнен автоматический отступ для текста, если выравнивание текста в ячейке установлено на равномерное распределение.Indicates if text is automatically indented when the text alignment in a cell is set to equal distribution.
textOrientationtextOrientation Ориентация текста для стиля.The text orientation for the style.
SubtotalsSubtotals automaticautomatic Если для свойства Automatic установлено значение true, все остальные значения будут игнорироваться при настройке промежуточных итогов.If Automatic is set to true, then all other values will be ignored when setting the Subtotals.
вычисленияaverage
countcount
КаунтнумберсcountNumbers
Maxmax
минутmin
Продукцияproduct
СтандарддевиатионstandardDeviation
СтандарддевиатионпstandardDeviationP
произведенsum
различvariance
ВарианцепvarianceP
TableTable legacyIdlegacyId Возвращает числовой идентификатор.Returns a numeric id.
TableChangedEventArgsTableChangedEventArgs getRange(ctx: Excel.RequestContext)getRange(ctx: Excel.RequestContext) Получает диапазон, представляющий измененную область таблицы на конкретном листе.Gets the range that represents the changed area of a table on a specific worksheet.
getRangeOrNullObject(ctx: Excel.RequestContext)getRangeOrNullObject(ctx: Excel.RequestContext) Получает диапазон, представляющий измененную область таблицы на конкретном листе.Gets the range that represents the changed area of a table on a specific worksheet. Может возвращать пустой объект.It might return null object.
WorkbookWorkbook readOnlyreadOnly Значение true, если книга открыта в режиме только для чтения.True if the workbook is open in Read-only mode. Только для чтения.Read-only.
ВоркбуккреатедWorkbookCreated WorksheetWorksheet oncalculatedonCalculated Возникает при вычислении листа.Occurs when the worksheet is calculated.
ШовгридлинесshowGridlines Получает или задает флаг линий сетки листа.Gets or sets the worksheet's gridlines flag.
ШовхеадингсshowHeadings Получает или задает флаг заголовков листа.Gets or sets the worksheet's headings flag.
ВоркшиткалкулатедевентаргсWorksheetCalculatedEventArgs typetype Получает тип события.Gets the type of the event. Дополнительные сведения см. в статье Excel.EventType.See Excel.EventType for details.
worksheetIdworksheetId Получает идентификатор листа, который рассчитывается.Gets the id of the worksheet that is calculated.
WorksheetChangedEventArgsWorksheetChangedEventArgs getRange(ctx: Excel.RequestContext)getRange(ctx: Excel.RequestContext) Получает диапазон, представляющий измененную область конкретного листа.Gets the range that represents the changed area of a specific worksheet.
getRangeOrNullObject(ctx: Excel.RequestContext)getRangeOrNullObject(ctx: Excel.RequestContext) Получает диапазон, представляющий измененную область конкретного листа.Gets the range that represents the changed area of a specific worksheet. Может возвращать пустой объект.It might return null object.
WorksheetCollectionWorksheetCollection oncalculatedonCalculated Возникает при вычислении любого листа в книге.Occurs when any worksheet in the workbook is calculated.

См. такжеSee also