Class PieChartBuilder

PieChartBuilder

Narzędzie do tworzenia 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()ChartTworzy wykres.
reverseCategories()PieChartBuilderOdwraca rysowanie serii na osi domeny.
set3D()PieChartBuilderUstawia wykres jako trójwymiarowy.
setBackgroundColor(cssValue)PieChartBuilderUstawia kolor tła wykresu.
setColors(cssValues)PieChartBuilderUstawia kolory linii na wykresie.
setDataSourceUrl(url)PieChartBuilderUstawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze.
setDataTable(tableBuilder)PieChartBuilderKonfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder.
setDataTable(table)PieChartBuilderUstawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X.
setDataViewDefinition(dataViewDefinition)PieChartBuilderOkreśla definicję widoku danych, która będzie używana na wykresie.
setDimensions(width, height)PieChartBuilderUstawia wymiary wykresu.
setLegendPosition(position)PieChartBuilderOkreśla pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)PieChartBuilderOkreśla styl tekstu legendy wykresu.
setOption(option, value)PieChartBuilderOkreśla zaawansowane opcje tego wykresu.
setTitle(chartTitle)PieChartBuilderOkreśla tytuł wykresu.
setTitleTextStyle(textStyle)PieChartBuilderOkreśla styl tekstu tytułu wykresu.

Szczegółowa dokumentacja

build()

Tworzy wykres.

Powrót

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


reverseCategories()

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

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


set3D()

Ustawia wykres jako trójwymiarowy.

Powrót

PieChartBuilder – to kreator przydatny w przypadku ł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").

Powrót

PieChartBuilder – to kreator przydatny w przypadku ł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 koloru, np. ["red", "#acf"]. N-ty element wskazuje kolor n-tej linii na wykresie.

Powrót

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


setDataSourceUrl(url)

Ustawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze. Jeśli podany jest URL źródła danych i tabela DataTable, adres URL źródła danych jest ignorowany.

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

Parametry

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

Powrót

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


setDataTable(tableBuilder)

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

Parametry

NazwaTypOpis
tableBuilderDataTableBuilderKreator tabel danych. W ramach tego parametru natychmiast jest tworzona nowa tabela danych , więc dalsze aktualizacje narzędzia nie zostaną odzwierciedlone na wykresie.

Powrót

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


setDataTable(table)

Ustawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X. pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Dowolna liczba kolumn po których może następować, wszystkie muszą mieć wartości liczbowe. Każda kolumna jest wyświetlana jako osobna linia.

Parametry

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

Powrót

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


setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych, która będzie używana na wykresie.

Parametry

NazwaTypOpis
dataViewDefinitionDataViewDefinitionObiekt definicji widoku danych, który określa widok, który powinien być na podstawie podanego źródła danych na potrzeby rysunku.

Powrót

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


setDimensions(width, height)

Ustawia wymiary wykresu.

Parametry

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

Powrót

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


setLegendPosition(position)

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

NazwaTypOpis
positionPositionPozycja legendy.

Powrót

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


setLegendTextStyle(textStyle)

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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany w legendzie wykresu.

Powrót

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


setOption(option, value)

Określa zaawansowane opcje tego wykresu. Zobacz dostępne opcje ten wykres. Ta metoda nie działa, jeśli dana 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 do ustawienia.
valueObjectWartość do ustawienia.

Powrót

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


setTitle(chartTitle)

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

NazwaTypOpis
chartTitleStringtytuł wykresu.

Powrót

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


setTitleTextStyle(textStyle)

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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł wykresu. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

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