Class EmbeddedHistogramChartBuilder

Dodaje zakres do wykresu edytowanego przez ten kreator. Nie dodaje zakresu, jeśli został już utworzony. który został dodany do wykresu.

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

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia typ wykresu na Wykres warstwowy i zwraca wartość EmbeddedAreaChartBuilder.

Powrót

EmbeddedAreaChartBuilder – narzędzie do tworzenia wykresów warstwowych

Ustawia typ wykresu na Wykres słupkowy i zwraca EmbeddedBarChartBuilder.

Powrót

EmbeddedBarChartBuilder – narzędzie do tworzenia wykresów słupkowych

Ustawia typ wykresu na ColumnChart i zwraca EmbeddedColumnChartBuilder.

Powrót

EmbeddedColumnChartBuilder – narzędzie do tworzenia wykresów kolumnowych.

Ustawia typ wykresu na ComboChart i zwraca wartość EmbeddedComboChartBuilder.

Powrót

EmbeddedComboChartBuilder – narzędzie do tworzenia wykresów mieszanych

Ustawia typ wykresu na HistogramChart i zwraca wartość EmbeddedHistogramChartBuilder.

Powrót

EmbeddedHistogramChartBuilder – narzędzie do tworzenia histogramu

Ustawia typ wykresu na Wykres liniowy i zwraca wartość EmbeddedLineChartBuilder.

Powrót

EmbeddedLineChartBuilder – narzędzie do tworzenia wykresów liniowych

Ustawia typ wykresu na Wykres kołowy i zwraca wartość EmbeddedPieChartBuilder.

Powrót

EmbeddedPieChartBuilder – narzędzie do tworzenia wykresu kołowego

Ustawia typ wykresu na wykres punktowy i zwraca wartość EmbeddedScatterChartBuilder.

Powrót

EmbeddedScatterChartBuilder – narzędzie do tworzenia wykresu punktowego

Ustawia typ wykresu na TableChart i zwraca EmbeddedTableChartBuilder.

Powrót

EmbeddedTableChartBuilder – narzędzie do tworzenia wykresów tabelarycznych

Tworzy wykres w sposób odzwierciedlający wszystkie wprowadzone w nim zmiany.

Ta metoda nie powoduje automatycznego rysowania w arkuszu kalkulacyjnym. Nowy wykres należy wstawić za pomocą sheet.insertChart(chart), a istniejący wykres powinien zostać zaktualizowany przez: sheet.updateChart(chart).

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Powrót

EmbeddedChart – utworzony wykres, który należy jeszcze dodać do arkusza kalkulacyjnego.

Usuwa wszystkie zakresy z wykresu edytowanego przez ten kreator.

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

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

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Zwraca bieżący typ wykresu.

Powrót

ChartType – typ wykresu,

Zwraca wykres ContainerInfo, który zawiera informacje o tym, gdzie na wykresie arkusza kalkulacyjnego.

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

var 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()
var containerInfo = chartBuilder.getContainer();

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

Powrót

ContainerInfo – obiekt zawierający pozycję kontenera wykresu.

Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu. Użyj narzędzi addRange(range) i removeRange(range), by zmodyfikować tę listę.

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

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

var ranges = chartBuilder.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());
}

Powrót

Range[] – tablica zakresów, która służy jako źródło danych do utworzenia wykresu

Usuwa określony zakres z wykresu edytowanego przez ten kreator. Nie zwraca błędu, jeśli: zakresu nie ma na tym wykresie.

Usunięty zakres musi pasować do zakresu dodanego za pomocą funkcji addRange(range); w przeciwnym razie wykres nie ulegnie zmianie. Tej metody nie można używać do częściowego usuwania wartości z zakresu.

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

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var 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"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Odwraca rysowanie serii na osi domeny. Na wykresach pionowych (np. liniowych, wykresów warstwowych lub kolumnowych), oznacza to, że oś pozioma jest rysowana od prawej do lewej. Dla: na wykresach poziomych (np. słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. w dół. W przypadku wykresów kołowych wycinki są rysowane w lewo.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Ustawia kolor tła wykresu.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Zmienia typ wykresu. Nie wszystkie typy wykresów umieszczanych są obecnie obsługiwane. Zobacz ChartType.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia kolory linii na wykresie.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa strategię, która ma być stosowana w przypadku ukrytych wierszy i kolumn. Domyślna wartość to 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();

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa pozycję legendy względem wykresu. Domyślnie nie ma legendy.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa styl tekstu legendy wykresu.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Ustawia strategię scalania używaną, gdy istnieje więcej niż 1 zakres. Jeśli MERGE_ROWS, wiersze są scalane; jeśli MERGE_COLUMNS, kolumny zostaną scalone. Domyślna wartość to MERGE_COLUMNS.

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

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var 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);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa liczbę wierszy lub kolumn w zakresie, które mają być traktowane jako nagłówki.

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

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa zaawansowane opcje tego wykresu. Listę dostępnych opcji znajdziesz w sekcji Wykres opcje konfiguracji.

Ta metoda nie sprawdza, czy podana opcja jest odpowiednia dla tego typu wykresu ani jeśli ma prawidłowy format/strukturę.

Ten przykład pokazuje, jak zmienić tytuł i ustawić legendę.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Parametry

Powrót

EmbeddedChartBuilder – narzędzie do tworzenia łańcuchów.

Ustawia położenie, zmieniając miejsce, w którym wykres ma pojawić się w arkuszu. anchorRowPos i anchorColPos mają 1 indeks.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa zakres wykresu.

Jeśli jakieś punkty danych wykraczają poza zakres, zakres się powiększa, aby uwzględnić te dane. pkt.

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Używa linii skumulowanych, co oznacza, że wartości linii i słupków są skumulowane (skumulowane). Domyślnie nie ma więc żadnego sposobu grupowania.

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa tytuł wykresu. Tytuł jest wyświetlany na środku nad wykresem.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa styl tekstu tytułu wykresu.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa, czy wiersze i kolumny wykresu mają być transponowane. Jeśli ma wartość true, wiersze i kolumny zostaną przełączone. Domyślna wartość to false.

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)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametry

Powrót

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa styl tekstu osi poziomej.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i wyświetla się pod wartością osi. etykiety.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa styl tekstu tytułu na osi poziomej.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa styl tekstu osi pionowej.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i wyświetla się po lewej stronie wartości. etykiety.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa styl tekstu tytułu osi pionowej.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parametry

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.

Przekształca oś zakresu w skalę logarytmiczną (wszystkie wartości muszą być dodatnie). Zakres są osią pionową dla wykresów pionowych (np. liniowe, warstwowe lub kolumnowe). oś pozioma w przypadku wykresów poziomych (np. słupkowych).

Powrót

EmbeddedHistogramChartBuilder – to kreator przydatny w przypadku łańcuchów.