Представляет диаграмму, встроенную в электронную таблицу.
В этом примере показано, как изменить существующую диаграмму:
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». Однако предполагается, что часть имени файла, которая следует за последней точкой (если она есть), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.12.25.2014» становится «Список покупок.12.25.pdf».
Чтобы просмотреть дневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.
Параметры
Имя | Тип | Описание |
---|---|---|
contentType | String | Тип MIME для преобразования. Для большинства BLOB '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());
Возвращаться
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(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
— конструктор для создания встроенных диаграмм