Ta strona została przetłumaczona przez Cloud Translation API.

Class EmbeddedPieChartBuilder

Tworzenie wykresów kołowych. Więcej informacji znajdziesz w dokumentacji Gviz.

Metody

Metoda	Zwracany typ	Krótki opis
`addRange(range)`	`EmbeddedChartBuilder`	Dodaje zakres do wykresu modyfikowanego przez ten kreator.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Ustawia typ wykresu na AreaChart i zwraca `EmbeddedAreaChartBuilder`.
`asBarChart()`	`EmbeddedBarChartBuilder`	Ustawia typ wykresu na „BarChart” i zwraca `EmbeddedBarChartBuilder`.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Ustawia typ wykresu na ColumnChart i zwraca `EmbeddedColumnChartBuilder`.
`asComboChart()`	`EmbeddedComboChartBuilder`	Ustawia typ wykresu na „ComboChart” i zwraca `EmbeddedComboChartBuilder`.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Ustawia typ wykresu na HistogramChart i zwraca `EmbeddedHistogramChartBuilder`.
`asLineChart()`	`EmbeddedLineChartBuilder`	Ustawia typ wykresu na „LineChart” i zwraca `EmbeddedLineChartBuilder`.
`asPieChart()`	`EmbeddedPieChartBuilder`	Ustawia typ wykresu na PieChart i zwraca `EmbeddedPieChartBuilder`.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Ustawia typ wykresu na ScatterChart i zwraca `EmbeddedScatterChartBuilder`.
`asTableChart()`	`EmbeddedTableChartBuilder`	Ustawia typ wykresu na „Tabela” i zwraca `EmbeddedTableChartBuilder`.
`build()`	`EmbeddedChart`	Tworzy wykres, uwzględniając wszystkie wprowadzone w nim zmiany.
`clearRanges()`	`EmbeddedChartBuilder`	Usuwa z wykresu wszystkie zakresy, które modyfikuje ten kreator.
`getChartType()`	`ChartType`	Zwraca bieżący typ wykresu.
`getContainer()`	`ContainerInfo`	Zwraca wykres `ContainerInfo`, który zawiera informacje o tym, gdzie wykres jest widoczny w arkuszu.
`getRanges()`	`Range[]`	Zwraca kopię listy zakresów, które obecnie dostarczają dane na potrzeby tego wykresu.
`removeRange(range)`	`EmbeddedChartBuilder`	Usuwa określony zakres z wykresu modyfikowanego przez ten kreator.
`reverseCategories()`	`EmbeddedPieChartBuilder`	Odwraca kolejność rysowania serii na osi domeny.
`set3D()`	`EmbeddedPieChartBuilder`	Ustawia wykres jako trójwymiarowy.
`setBackgroundColor(cssValue)`	`EmbeddedPieChartBuilder`	Ustawia kolor tła wykresu.
`setChartType(type)`	`EmbeddedChartBuilder`	Zmienia typ wykresu.
`setColors(cssValues)`	`EmbeddedPieChartBuilder`	Ustawia kolory linii na wykresie.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Określa strategię używaną w przypadku ukrytych wierszy i kolumn.
`setLegendPosition(position)`	`EmbeddedPieChartBuilder`	Określa położenie legendy względem wykresu.
`setLegendTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Ustawia styl tekstu legendy wykresu.
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Określa strategię scalania, której należy użyć, gdy istnieje więcej niż 1 zakres.
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	Określa liczbę wierszy lub kolumn zakresu, które mają być traktowane jako nagłówki.
`setOption(option, value)`	`EmbeddedChartBuilder`	Ustawia zaawansowane opcje wykresu.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Ustawia położenie wykresu na arkuszu.
`setTitle(chartTitle)`	`EmbeddedPieChartBuilder`	Ustawia tytuł wykresu.
`setTitleTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Ustawia styl tekstu tytułu wykresu.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Określa, czy wiersze i kolumny wykresu mają być zamieniane miejscami.

Szczegółowa dokumentacja

`addRange(range)`

Dodaje zakres do wykresu modyfikowanego przez ten kreator. Nie dodaje zakresu, jeśli został on już dodany do wykresu.

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

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres do dodania.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`asAreaChart()`

Ustawia typ wykresu na AreaChart i zwraca EmbeddedAreaChartBuilder.

Powrót

EmbeddedAreaChartBuilder – kreator wykresu warstwowego

`asBarChart()`

Ustawia typ wykresu na „BarChart” i zwraca EmbeddedBarChartBuilder.

Powrót

EmbeddedBarChartBuilder – kreator wykresu słupkowego,

`asColumnChart()`

Ustawia typ wykresu na ColumnChart i zwraca EmbeddedColumnChartBuilder.

Powrót

EmbeddedColumnChartBuilder – kreator wykresu kolumnowego

`asComboChart()`

Ustawia typ wykresu na „ComboChart” i zwraca EmbeddedComboChartBuilder.

Powrót

EmbeddedComboChartBuilder – kreator wykresu mieszanego

`asHistogramChart()`

Ustawia typ wykresu na HistogramChart i zwraca EmbeddedHistogramChartBuilder.

Powrót

EmbeddedHistogramChartBuilder – kreator histogramu

`asLineChart()`

Ustawia typ wykresu na „LineChart” i zwraca EmbeddedLineChartBuilder.

Powrót

EmbeddedLineChartBuilder – kreator wykresu liniowego

`asPieChart()`

Ustawia typ wykresu na PieChart i zwraca EmbeddedPieChartBuilder.

Powrót

EmbeddedPieChartBuilder – kreator wykresu kołowego

`asScatterChart()`

Ustawia typ wykresu na ScatterChart i zwraca EmbeddedScatterChartBuilder.

Powrót

EmbeddedScatterChartBuilder – kreator wykresu punktowego

`asTableChart()`

Ustawia typ wykresu na „Tabela” i zwraca EmbeddedTableChartBuilder.

Powrót

EmbeddedTableChartBuilder – kreator wykresu tabelarycznego

`build()`

Tworzy wykres, uwzględniając wszystkie wprowadzone w nim zmiany.

Ta metoda nie powoduje automatycznego rysowania wykresu na wierzchu arkusza kalkulacyjnego. Nowy wykres należy wstawić za pomocą sheet.insertChart(chart), a istniejący zaktualizować za pomocą 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);

Powrót

EmbeddedChart – utworzony wykres, który musi zostać dodany do arkusza kalkulacyjnego.

`clearRanges()`

Usuwa z wykresu wszystkie zakresy, które modyfikuje ten kreator.

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

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`getChartType()`

Zwraca bieżący typ wykresu.

Powrót

ChartType – typ wykresu

`getContainer()`

Zwraca wykres ContainerInfo, który zawiera informacje o tym, gdzie wykres jest widoczny w arkuszu.

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

Powrót

ContainerInfo – obiekt zawierający położenie kontenera wykresu

`getRanges()`

Zwraca kopię listy zakresów, które obecnie dostarczają dane na potrzeby tego wykresu. Aby zmodyfikować tę listę, użyj opcji addRange(range) i removeRange(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());
}

Powrót

Range[] – tablica zakresów, które służą jako źródło danych wykresu, który ma zostać utworzony

`removeRange(range)`

Usuwa określony zakres z wykresu modyfikowanego przez ten kreator. Nie powoduje błędu, jeśli zakres nie znajduje się na tym wykresie.

Usuwany zakres musi być zgodny z zakresem dodanym za pomocą addRange(range). W przeciwnym razie wykres nie ulegnie zmianie. Tej metody nie można użyć do częściowego usuwania wartości z zakresu.

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

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres do usunięcia.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`reverseCategories()`

Odwraca kolejność rysowania serii na osi domeny. W przypadku wykresów z zakresem pionowym (np. wykresów liniowych, powierzchniowych lub słupkowych) oznacza to, że oś pozioma jest rysowana od prawej do lewej. W przypadku wykresów z zakresem poziomym (np. wykresów słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. W przypadku wykresów kołowych oznacza to, że sektory są rysowane w przeciwnym kierunku do ruchu wskazówek zegara.

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

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`set3D()`

Ustawia wykres jako trójwymiarowy.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setBackgroundColor(cssValue)`

Ustawia kolor tła wykresu.

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

Parametry

Nazwa	Typ	Opis
`cssValue`	`String`	Wartość CSS koloru (np. `"blue"` lub `"#00f"`).

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setChartType(type)`

Zmienia typ wykresu. Obecnie nie wszystkie typy osadzonych wykresów są obsługiwane. Zobacz ChartType.

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

Parametry

Nazwa	Typ	Opis
`type`	`ChartType`	Typ, na który chcesz zmienić ten wykres.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`setColors(cssValues)`

Ustawia kolory linii na wykresie.

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

Parametry

Nazwa	Typ	Opis
`cssValues`	`String[]`	Tablica wartości kolorów CSS, np. `["red", "#acf"]`. Element n tablicy reprezentuje kolor linii n na wykresie.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setHiddenDimensionStrategy(strategy)`

Określa strategię używaną w przypadku ukrytych wierszy i kolumn. Domyślna wartość to 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);

Parametry

Nazwa	Typ	Opis
`strategy`	`ChartHiddenDimensionStrategy`	Strategia stosowana w przypadku ukrytych wierszy i kolumn.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`setLegendPosition(position)`

Określa położenie legendy względem wykresu. Domyślnie legenda nie jest wyświetlana.

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

Parametry

Nazwa	Typ	Opis
`position`	`Position`	Pozycja legendy.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setLegendTextStyle(textStyle)`

Ustawia styl tekstu legendy wykresu.

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

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w legendzie wykresu.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setMergeStrategy(mergeStrategy)`

Określa strategię scalania, której należy użyć, gdy istnieje więcej niż 1 zakres. Jeśli MERGE_ROWS, wiersze są scalane; jeśli MERGE_COLUMNS, kolumny są scalane. Domyślna wartość to 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);

Parametry

Nazwa	Typ	Opis
`mergeStrategy`	`ChartMergeStrategy`	Strategia łączenia do użycia.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`setNumHeaders(headers)`

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

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

Parametry

Nazwa	Typ	Opis
`headers`	`Integer`	Liczba wierszy lub kolumn, które mają być traktowane jako nagłówki. Wartości ujemne powodują automatyczne wykrywanie nagłówków.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`setOption(option, value)`

Ustawia zaawansowane opcje wykresu. Listę dostępnych opcji znajdziesz w sekcji Opcje konfiguracji wykresu.

Ta metoda nie sprawdza, czy wybrana opcja jest odpowiednia dla tego typu wykresu ani czy wartość ma prawidłowy format lub strukturę.

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

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

Parametry

Nazwa	Typ	Opis
`option`	`String`	Nazwa opcji.
`value`	`Object`	Wartość opcji.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Ustawia położenie wykresu na arkuszu. Funkcje anchorRowPos i anchorColPos są indeksowane od 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);

Parametry

Nazwa	Typ	Opis
`anchorRowPos`	`Integer`	Górna krawędź wykresu jest przypięta do tego wiersza.
`anchorColPos`	`Integer`	Lewa strona wykresu jest zakotwiczona w tej kolumnie.
`offsetX`	`Integer`	Prawy górny róg wykresu jest przesunięty o tyle pikseli.
`offsetY`	`Integer`	Lewym dolnym rogu wykresu przesuwa się o tyle pikseli.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania

`setTitle(chartTitle)`

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

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

Parametry

Nazwa	Typ	Opis
`chartTitle`	`String`	tytuł wykresu.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setTitleTextStyle(textStyle)`

Ustawia styl tekstu tytułu wykresu.

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

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu, który ma być używany w tytule wykresu. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując funkcję `Charts.newTextStyle()`.

Powrót

EmbeddedPieChartBuilder – ten kreator jest przydatny do łańcuchowania.

`setTransposeRowsAndColumns(transpose)`

Określa, czy wiersze i kolumny wykresu mają być zamieniane miejscami. Jeśli ustawisz wartość true, wiersze i kolumny zostaną zamienione. Domyślna wartość to 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);

Parametry

Nazwa	Typ	Opis
`transpose`	`Boolean`	Jeśli `true`, wiersze i kolumny użyte do stworzenia wykresu zostaną zamienione miejscami.

Powrót

EmbeddedChartBuilder – ten kreator do łańcuchowania