Class ScatterChartBuilder

ScatterChartBuilder

Narzędzie do tworzenia wykresów punktowych. Więcej informacji znajdziesz w dokumentacji Wykresów Google.

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

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

var chartBuilder = Charts.newScatterChart()
    .setTitle('Adjusted GDP & U.S. Population')
    .setXAxisTitle('U.S. Population (millions)')
    .setYAxisTitle('Adjusted GDP ($ billions)')
    .setDimensions(600, 500)
    .setLegendPosition(Charts.Position.NONE)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
build()	Chart	Tworzenie wykresu.
setBackgroundColor(cssValue)	ScatterChartBuilder	Ustawia kolor tła wykresu.
setColors(cssValues)	ScatterChartBuilder	Ustawia kolory linii na wykresie.
setDataSourceUrl(url)	ScatterChartBuilder	Ustawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google.
setDataTable(tableBuilder)	ScatterChartBuilder	Konfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder.
setDataTable(table)	ScatterChartBuilder	Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X.
setDataViewDefinition(dataViewDefinition)	ScatterChartBuilder	Określa definicję widoku danych używaną na wykresie.
setDimensions(width, height)	ScatterChartBuilder	Ustawia wymiary wykresu.
setLegendPosition(position)	ScatterChartBuilder	Określa pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu legendy wykresu.
setOption(option, value)	ScatterChartBuilder	Ustawia zaawansowane opcje wykresu.
setPointStyle(style)	ScatterChartBuilder	Ustawia styl punktów na linii.
setTitle(chartTitle)	ScatterChartBuilder	Ustawia tytuł wykresu.
setTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu wykresu.
setXAxisLogScale()	ScatterChartBuilder	Zmienia oś poziomą w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).
setXAxisRange(start, end)	ScatterChartBuilder	Ustawia zakres osi poziomej wykresu.
setXAxisTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu osi poziomej.
setXAxisTitle(title)	ScatterChartBuilder	Dodaje tytuł do osi poziomej.
setXAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu osi poziomej.
setYAxisLogScale()	ScatterChartBuilder	Zmienia oś pionową w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).
setYAxisRange(start, end)	ScatterChartBuilder	Ustawia zakres dla osi pionowej wykresu.
setYAxisTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu osi pionowej.
setYAxisTitle(title)	ScatterChartBuilder	Dodaje tytuł do osi pionowej.
setYAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu osi pionowej.

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.

---

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

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

Powroty

ScatterChartBuilder – 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

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

Powroty

ScatterChartBuilder – 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

Nazwa	Typ	Opis
url	String	Adres URL źródła danych wraz z parametrami zapytania.

Powroty

ScatterChartBuilder – 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

Nazwa	Typ	Opis
tableBuilder	DataTableBuilder	Kreator tabel danych. W ramach tego wywołania natychmiast tworzona jest nowa tabela danych, więc dalsze aktualizacje kreatora nie są odzwierciedlane na wykresie.

Powroty

ScatterChartBuilder – 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

Nazwa	Typ	Opis
table	DataTableSource	Tabela danych, która ma być używana na wykresie.

Powroty

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

---

setDataViewDefinition(dataViewDefinition)

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

Parametry

Nazwa	Typ	Opis
dataViewDefinition	DataViewDefinition	Obiekt definicji widoku danych określający widok, który powinien pochodzić z danego źródła danych na potrzeby wykresu.

Powroty

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

---

setDimensions(width, height)

Ustawia wymiary wykresu.

Parametry

Nazwa	Typ	Opis
width	Integer	Szerokość wykresu w pikselach.
height	Integer	Wysokość wykresu w pikselach.

Powroty

ScatterChartBuilder – 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

Nazwa	Typ	Opis
position	Position	Pozycja legendy.

Powroty

ScatterChartBuilder – 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

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

Powroty

ScatterChartBuilder – 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 scatter chart with a 1-second animation duration.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parametry

Nazwa	Typ	Opis
option	String	Opcja umożliwiająca ustawienie.
value	Object	Wartość do ustawienia.

Powroty

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

---

setPointStyle(style)

Ustawia styl punktów na linii. Domyślnie punkty nie mają określonych stylów i widoczna jest tylko linia.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parametry

Nazwa	Typ	Opis
style	PointStyle	Styl używany dla punktów na linii.

Powroty

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

Zobacz też

• PointStyle

---

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

Nazwa	Typ	Opis
chartTitle	String	tytuł wykresu.

Powroty

ScatterChartBuilder – 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

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu używany w tytule wykresu. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

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

---

setXAxisLogScale()

Zmienia oś poziomą w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).

Powroty

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

---

setXAxisRange(start, end)

Ustawia zakres osi poziomej wykresu.

Jeśli jakieś punkty danych wykraczają poza zakres, zakres jest poszerzany, by uwzględnić te punkty.

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parametry

Nazwa	Typ	Opis
start	Number	Wartość najniższej linii siatki na osi poziomej.
end	Number	Wartość najwyższej linii siatki na osi poziomej.

Powroty

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

---

setXAxisTextStyle(textStyle)

Ustawia 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

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu używany w tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

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

---

setXAxisTitle(title)

Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i pojawia się pod etykietami wartości osi.

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

Parametry

Nazwa	Typ	Opis
title	String	Tytuł osi X.

Powroty

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

---

setXAxisTitleTextStyle(textStyle)

Ustawia styl tekstu tytułu 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

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu używany w tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

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

---

setYAxisLogScale()

Zmienia oś pionową w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).

Powroty

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

---

setYAxisRange(start, end)

Ustawia zakres dla osi pionowej wykresu. Jeśli jakieś punkty danych wykraczają poza zakres, zakres jest rozszerzany o te punkty.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parametry

Nazwa	Typ	Opis
start	Number	Wartość najniższej linii siatki na osi pionowej.
end	Number	Wartość najwyższej linii siatki na osi pionowej.

Powroty

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

---

setYAxisTextStyle(textStyle)

Ustawia 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

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu używany w tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

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

---

setYAxisTitle(title)

Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i wyświetla się na lewo od etykiet wartości.

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

Parametry

Nazwa	Typ	Opis
title	String	Tytuł osi Y.

Powroty

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

---

setYAxisTitleTextStyle(textStyle)

Ustawia 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

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu używany w tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powroty

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