Class PieChartBuilder

PieChartBuilder

Kreator wykresów kołowych. Więcej informacji znajdziesz w dokumentacji Wykresów Google.

Oto przykład, który pokazuje, jak utworzyć wykres kołowy. Dane są zaimportowane z arkusza kalkulacyjnego Google.

  // Get sample data from a spreadsheet.
  var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Metody

MetodaZwracany typKrótki opis
build()ChartTworzenie wykresu.
reverseCategories()PieChartBuilderOdwraca rysunek serii na osi domeny.
set3D()PieChartBuilderUstawia trójwymiarowy wykres.
setBackgroundColor(cssValue)PieChartBuilderUstawia kolor tła wykresu.
setColors(cssValues)PieChartBuilderUstawia kolory linii na wykresie.
setDataSourceUrl(url)PieChartBuilderUstawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google.
setDataTable(tableBuilder)PieChartBuilderKonfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder.
setDataTable(table)PieChartBuilderUstawia tabelę danych, która zawiera linie wykresu i etykiety osi X.
setDataViewDefinition(dataViewDefinition)PieChartBuilderOkreśla definicję widoku danych używaną na wykresie.
setDimensions(width, height)PieChartBuilderUstawia wymiary wykresu.
setLegendPosition(position)PieChartBuilderOkreśla pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)PieChartBuilderUstawia styl tekstu legendy wykresu.
setOption(option, value)PieChartBuilderUstawia zaawansowane opcje wykresu.
setTitle(chartTitle)PieChartBuilderUstawia tytuł wykresu.
setTitleTextStyle(textStyle)PieChartBuilderUstawia styl tekstu tytułu wykresu.

Szczegółowa dokumentacja

build()

Tworzenie wykresu.

Powroty

Chart – obiekt wykresu, który można umieszczać w dokumentach i elementach interfejsu albo używać jako obrazów statycznych.


reverseCategories()

Odwraca rysunek serii na osi domeny. W przypadku wykresów pionowych (np. liniowych, warstwowych lub kolumnowych) oznacza to, że oś pozioma jest rysowana od prawej do lewej. W przypadku wykresów poziomych (np. słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. 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();

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


set3D()

Ustawia trójwymiarowy wykres.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setBackgroundColor(cssValue)

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

NazwaTypOpis
cssValueStringWartość CSS koloru (np. "blue" lub "#00f").

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametry

NazwaTypOpis
cssValuesString[]Tablica wartości CSS kolorów, np. ["red", "#acf"]. N-ty element tablicy reprezentuje kolor n-tej linii na wykresie.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataSourceUrl(url)

Ustawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google. Jeśli podasz adres URL źródła danych i tabelę DataTable, adres URL źródła danych zostanie zignorowany.

Więcej informacji o wykonywaniu zapytań dotyczących źródeł danych znajdziesz w dokumentacji Wykresów Google.

Parametry

NazwaTypOpis
urlStringAdres URL źródła danych wraz z parametrami zapytania.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataTable(tableBuilder)

Konfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder. Jest to wygodna metoda ustawiania tabeli danych bez konieczności wywoływania funkcji build().

Parametry

NazwaTypOpis
tableBuilderDataTableBuilderKreator tabel danych. W ramach tego wywołania natychmiast tworzona jest nowa tabela danych, więc dalsze aktualizacje kreatora nie są odzwierciedlane na wykresie.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataTable(table)

Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X. Pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Po niej może następować dowolna liczba kolumn, a wszystkie muszą mieć wartości liczbowe. Każda kolumna jest wyświetlana jako osobny wiersz.

Parametry

NazwaTypOpis
tableDataTableSourceTabela danych, która ma być używana na wykresie.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych używaną na wykresie.

Parametry

NazwaTypOpis
dataViewDefinitionDataViewDefinitionObiekt definicji widoku danych określający widok, który powinien pochodzić z danego źródła danych na potrzeby wykresu.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDimensions(width, height)

Ustawia wymiary wykresu.

Parametry

NazwaTypOpis
widthIntegerSzerokość wykresu w pikselach.
heightIntegerWysokość wykresu w pikselach.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setLegendPosition(position)

Określa pozycję legendy względem wykresu. Domyślnie legenda nie jest wyświetlana.

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

Parametry

NazwaTypOpis
positionPositionPozycja legendy.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setLegendTextStyle(textStyle)

Ustawia 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

NazwaTypOpis
textStyleTextStyleStyl tekstu używany w legendzie wykresu.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setOption(option, value)

Ustawia zaawansowane opcje wykresu. Zobacz dostępne opcje tego wykresu. Ta metoda nie działa, jeśli podana opcja jest nieprawidłowa.

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

Parametry

NazwaTypOpis
optionStringOpcja umożliwiająca ustawienie.
valueObjectWartość do ustawienia.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setTitle(chartTitle)

Ustawia tytuł wykresu. Tytuł jest wyśrodkowany nad wykresem.

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

Parametry

NazwaTypOpis
chartTitleStringtytuł wykresu.

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.


setTitleTextStyle(textStyle)

Ustawia 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

NazwaTypOpis
textStyleTextStyleStyl tekstu używany w tytule wykresu. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

PieChartBuilder – kreator przydatny do tworzenia łańcuchów.