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' .

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

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());

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

ChartMergeStrategyMERGE_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());

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

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


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 — конструктор для создания встроенных диаграмм.