Class EmbeddedTableChartBuilder

Добавляет диапазон к диаграмме, которую изменяет этот построитель. Не добавляет диапазон, если он уже добавлен на диаграмму.

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

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

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Задает тип диаграммы AreaChart и возвращает Embedded Area Chart Builder .

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

Embedded Area Chart Builder — построитель диаграммы с областями.

Устанавливает тип диаграммы BarChart и возвращает Embedded Bar Chart Builder .

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

Embedded Bar Chart Builder — конструктор гистограмм.

Задает тип диаграммы ColumnChart и возвращает Embedded Column Chart Builder .

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

Embedded Column Chart Builder — построитель столбчатых диаграмм.

Задает тип диаграммы ComboChart и возвращает Embedded Combo Chart Builder .

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

Embedded Combo Chart Builder — конструктор комбинированных диаграмм.

Задает тип диаграммы HistogramChart и возвращает Embedded Histogram Chart Builder .

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

Embedded Histogram Chart Builder — конструктор гистограмм.

Устанавливает тип диаграммы LineChart и возвращает Embedded Line Chart Builder .

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

Embedded Line Chart Builder — конструктор линейных диаграмм.

Задает тип диаграммы PieChart и возвращает Embedded Pie Chart Builder .

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

Embedded Pie Chart Builder — конструктор круговых диаграмм.

Задает тип диаграммы ScatterChart и возвращает Embedded Scatter Chart Builder .

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

Embedded Scatter Chart Builder — построитель точечной диаграммы

Задает тип диаграммы TableChart и возвращает Embedded Table Chart Builder .

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

Embedded Table Chart Builder — конструктор табличной диаграммы.

Строит диаграмму, отражающую все внесенные в нее изменения.

Этот метод не рисует диаграмму автоматически поверх электронной таблицы. Новую диаграмму необходимо вставить с sheet.insertChart(chart) , а существующую диаграмму следует обновить с sheet.updateChart(chart) .

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

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

Embedded Chart — созданная диаграмма, которую еще нужно добавить в таблицу.

Удаляет все диапазоны из диаграммы, которую изменяет этот построитель.

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

// This code updates the chart to use only the new ranges while preserving the
// existing formatting of the chart.
const chart = sheet.getCharts()[0];
const newChart = chart.modify()
                     .clearRanges()
                     .addRange(sheet.getRange('A1:A5'))
                     .addRange(sheet.getRange('B1:B5'))
                     .build();
sheet.updateChart(newChart);

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

Embedded Chart Builder — этот построитель для создания цепочек

Устанавливает, включать ли постраничное перелистывание данных.

Поведение по умолчанию — подкачка отключена. Если разбиение по страницам включено, размер страницы по умолчанию равен 10.

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Включает разбиение по страницам и устанавливает количество строк на каждой странице.

Размер страницы по умолчанию — 10.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Включает разбиение по страницам, устанавливает количество строк на каждой странице и первую отображаемую страницу таблицы (номера страниц начинаются с нуля).

Размер страницы по умолчанию — 10, а стартовая страница по умолчанию — 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Добавляет базовую поддержку языков с письмом справа налево (таких как арабский или иврит), изменяя порядок столбцов таблицы на противоположный, так что нулевой столбец является самым правым столбцом, а последний столбец — самым левым столбцом.

Это не влияет на индекс столбца в базовых данных, а только на порядок отображения. Полное двунаправленное языковое отображение (BiDi) не поддерживается визуализацией таблицы даже при использовании этой опции. Этот параметр игнорируется, если вы включаете разбивку по страницам (используя параметр страницы) или если в таблице есть полосы прокрутки, поскольку вы указали параметры высоты и ширины, меньшие, чем требуемый размер таблицы. По умолчанию поддержка RTL отключена.

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Определяет, сортировать ли столбцы, когда пользователь щелкает заголовок столбца.

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

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Возвращает текущий тип диаграммы.

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

Chart Type — тип диаграммы

Верните Container Info диаграммы, которая инкапсулирует расположение диаграммы на листе.

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

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(sheet.getRange('A1:B8'))
                         .setPosition(5, 5, 0, 0);

// This method returns the exact same data as Chart#getContainerInfo()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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(),
);

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

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

Возвращает копию списка диапазонов, в настоящее время предоставляющих данные для этой диаграммы. Используйте add Range(range) и remove Range(range) чтобы изменить этот список.

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

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(sheet.getRange('A1:B8'))
                         .setPosition(5, 5, 0, 0);

const ranges = chartBuilder.getRanges();

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

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

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

Удаляет указанный диапазон из диаграммы, которую изменяет этот построитель. Не выдает ошибку, если диапазон отсутствует на этой диаграмме.

Удаленный диапазон должен совпадать с диапазоном, добавленным с помощью add Range(range) ; в противном случае в диаграмму не вносятся никакие изменения. Этот метод нельзя использовать для частичного удаления значений из диапазона.

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(firstRange)
                         // This range will render in a different color
                         .addRange(secondRange)
                         .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Изменяет тип диаграммы. В настоящее время поддерживаются не все типы встроенных диаграмм. См. Chart Type .

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Устанавливает номер первой строки в таблице данных.

Номер строки по умолчанию для первой строки равен 1.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

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

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

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

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Устанавливает индекс столбца, по которому таблица должна быть изначально отсортирована (по возрастанию).

Столбец отсортирован по возрастанию и отмечен маленькой стрелкой, указывающей на это.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

Устанавливает индекс столбца, по которому должна быть изначально отсортирована таблица (по убыванию).

Столбец отсортирован по убыванию и отмечен маленькой стрелкой, указывающей на это.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

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

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

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

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

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

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

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

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Устанавливает дополнительные параметры для этой диаграммы. Чтобы просмотреть список доступных параметров, см. Параметры конфигурации диаграммы .

Этот метод не проверяет правильность указанного вами параметра для этого типа диаграммы и правильность формата/структуры значения.

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

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек.

Устанавливает положение, изменяя расположение диаграммы на листе. anchor Row Pos и anchor Col Pos имеют индекс 1.

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

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

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

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

sheet.insertChart(chart);

Параметры

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

Embedded Chart Builder — этот построитель для создания цепочек

Устанавливает, отображать ли номер строки в качестве первого столбца таблицы.

Поведение по умолчанию не показывает номера строк.

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.

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

Поведение по умолчанию — строки имеют чередующийся цветовой стиль.

Параметры

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

Embedded Table Chart Builder — этот построитель полезен для создания цепочек.