Эта страница переведена с помощью Cloud Translation API.

Class EmbeddedChart

Представляет диаграмму, внедренную в электронную таблицу.

В этом примере показано, как изменить существующую диаграмму:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2:B8")
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

В этом примере показано, как создать новую диаграмму:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

Методы

Метод	Тип возврата	Краткое описание
`asDataSourceChart()`	`DataSourceChart`	Приводится к экземпляру диаграммы источника данных, если диаграмма является диаграммой источника данных, или `null` в противном случае.
`getAs(contentType)`	`Blob`	Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
`getBlob()`	`Blob`	Верните данные внутри этого объекта в виде большого двоичного объекта.
`getChartId()`	`Integer`	Возвращает стабильный идентификатор диаграммы, который уникален во всей электронной таблице, содержащей диаграмму, или `null` , если диаграмма не находится в электронной таблице.
`getContainerInfo()`	`ContainerInfo`	Возвращает информацию о расположении диаграммы на листе.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Возвращает стратегию, используемую для обработки скрытых строк и столбцов.
`getMergeStrategy()`	`ChartMergeStrategy`	Возвращает стратегию слияния, используемую, когда существует более одного диапазона.
`getNumHeaders()`	`Integer`	Возвращает количество строк или столбцов диапазона, которые рассматриваются как заголовки.
`getOptions()`	`ChartOptions`	Возвращает параметры этой диаграммы, такие как высота, цвета и оси.
`getRanges()`	`Range[]`	Возвращает диапазоны, которые эта диаграмма использует в качестве источника данных.
`getTransposeRowsAndColumns()`	`Boolean`	Если `true` , строки и столбцы, используемые для заполнения диаграммы, меняются местами.
`modify()`	`EmbeddedChartBuilder`	Возвращает `EmbeddedChartBuilder` , который можно использовать для изменения этой диаграммы.

Подробная документация

`asDataSourceChart()`

Приводится к экземпляру диаграммы источника данных, если диаграмма является диаграммой источника данных, или null в противном случае.

Возвращаться

DataSourceChart — Диаграмма источника данных.

`getAs(contentType)`

Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет к имени файла соответствующее расширение, например «myfile.pdf». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.25.12.2014» становится «Список покупок.12.25.pdf».

Чтобы просмотреть ежедневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Имя	Тип	Описание
`contentType`	`String`	Тип MIME, в который требуется преобразовать. Для большинства больших двоичных объектов единственным допустимым вариантом является `'application/pdf'` . Для изображений в формате BMP, GIF, JPEG или PNG также допустимо любое из `'image/bmp'` , `'image/gif'` , `'image/jpeg'` или `'image/png'` . Для документа Google Docs также допустимо использование `'text/markdown'` .

Возвращаться

Blob — данные в виде большого двоичного объекта.

`getBlob()`

Верните данные внутри этого объекта в виде большого двоичного объекта.

Возвращаться

Blob — данные в виде большого двоичного объекта.

`getChartId()`

Возвращает стабильный идентификатор диаграммы, который уникален во всей электронной таблице, содержащей диаграмму, или null , если диаграмма не находится в электронной таблице.

Возвращаться

Integer — стабильный идентификатор диаграммы.

`getContainerInfo()`

Возвращает информацию о расположении диаграммы на листе.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var containerInfo = chart.getContainerInfo();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

Возвращаться

ContainerInfo — объект, содержащий позицию контейнера диаграммы.

`getHiddenDimensionStrategy()`

Возвращает стратегию, используемую для обработки скрытых строк и столбцов. По умолчанию IGNORE_ROWS .

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

Возвращаться

ChartHiddenDimensionStrategy — стратегия, используемая для скрытых строк и столбцов.

`getMergeStrategy()`

Возвращает стратегию слияния, используемую, когда существует более одного диапазона. Если MERGE_ROWS , строки объединяются; если MERGE_COLUMNS , столбцы объединяются. По умолчанию MERGE_COLUMNS .

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

Возвращаться

ChartMergeStrategy — MERGE_ROWS , если строки объединяются в нескольких диапазонах; MERGE_COLUMNS если столбцы объединены в нескольких диапазонах.

`getNumHeaders()`

Возвращает количество строк или столбцов диапазона, которые рассматриваются как заголовки.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

Возвращаться

Integer — количество строк или столбцов, рассматриваемых как заголовки. Отрицательные значения указывают, что заголовки определяются автоматически.

`getOptions()`

Возвращает параметры этой диаграммы, такие как высота, цвета и оси.

Возвращаемые параметры являются неизменяемыми.

Возвращаться

ChartOptions — параметры этой диаграммы, такие как высота, цвета и оси.

`getRanges()`

Возвращает диапазоны, которые эта диаграмма использует в качестве источника данных.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

Возвращаться

Range[] — массив диапазонов, которые служат источником данных для этой диаграммы.

`getTransposeRowsAndColumns()`

Если true , строки и столбцы, используемые для заполнения диаграммы, меняются местами. По умолчанию установлено значение false .

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .addRange(range)
    .setChartType(Charts.ChartType.BAR)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

Возвращаться

Boolean — true , если строки и столбцы, используемые для построения диаграммы, транспонированы.

`modify()`

Возвращает EmbeddedChartBuilder , который можно использовать для изменения этой диаграммы. Вызовитеsheet.updateChart sheet.updateChart(chart) чтобы сохранить любые изменения.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

Возвращаться

EmbeddedChartBuilder — конструктор для создания встроенных диаграмм.