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

MetodaZwracany typKrótki opis
build()ChartTworzy wykres.
setBackgroundColor(cssValue)ScatterChartBuilderUstawia kolor tła wykresu.
setColors(cssValues)ScatterChartBuilderUstawia kolory linii na wykresie.
setDataSourceUrl(url)ScatterChartBuilderUstawia 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)ScatterChartBuilderKonfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder.
setDataTable(table)ScatterChartBuilderUstawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X.
setDataViewDefinition(dataViewDefinition)ScatterChartBuilderOkreśla definicję widoku danych, która będzie używana na wykresie.
setDimensions(width, height)ScatterChartBuilderUstawia wymiary wykresu.
setLegendPosition(position)ScatterChartBuilderOkreśla pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu legendy wykresu.
setOption(option, value)ScatterChartBuilderOkreśla zaawansowane opcje tego wykresu.
setPointStyle(style)ScatterChartBuilderOkreśla styl punktów na linii.
setTitle(chartTitle)ScatterChartBuilderOkreśla tytuł wykresu.
setTitleTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu tytułu wykresu.
setXAxisLogScale()ScatterChartBuilderPrzekształca oś poziomą w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).
setXAxisRange(start, end)ScatterChartBuilderOkreśla zakres osi poziomej wykresu.
setXAxisTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu osi poziomej.
setXAxisTitle(title)ScatterChartBuilderDodaje tytuł do osi poziomej.
setXAxisTitleTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu tytułu na osi poziomej.
setYAxisLogScale()ScatterChartBuilderPrzekształca oś pionową w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).
setYAxisRange(start, end)ScatterChartBuilderOkreśla zakres osi pionowej wykresu.
setYAxisTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu osi pionowej.
setYAxisTitle(title)ScatterChartBuilderDodaje tytuł do osi pionowej.
setYAxisTitleTextStyle(textStyle)ScatterChartBuilderOkreśla styl tekstu tytułu osi pionowej.

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 .


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

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

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

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

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

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

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

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

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

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

Parametry

NazwaTypOpis
optionStringOpcja do ustawienia.
valueObjectWartość do ustawienia.

Powrót

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


setPointStyle(style)

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

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

Parametry

NazwaTypOpis
stylePointStyleStyl, który ma być używany w przypadku punktów na linii.

Powrót

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

Zobacz też


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

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

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


setXAxisLogScale()

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

Powrót

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


setXAxisRange(start, end)

Określa zakres osi poziomej wykresu.

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

// 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

NazwaTypOpis
startNumberWartość najniższej linii siatki na osi poziomej.
endNumberWartość najwyższej linii siatki na osi poziomej.

Powrót

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


setXAxisTextStyle(textStyle)

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

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

Powrót

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


setXAxisTitle(title)

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

NazwaTypOpis
titleStringTytuł osi X.

Powrót

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


setXAxisTitleTextStyle(textStyle)

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

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

Powrót

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


setYAxisLogScale()

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

Powrót

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


setYAxisRange(start, end)

Określa zakres osi pionowej wykresu. Jeśli jakieś punkty danych wykraczają poza zakres, zakres jest poszerzany o te punkty danych.

// 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

NazwaTypOpis
startNumberWartość najniższej linii siatki na osi pionowej.
endNumberWartość najwyższej linii siatki na osi pionowej.

Powrót

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


setYAxisTextStyle(textStyle)

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

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

Powrót

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


setYAxisTitle(title)

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

NazwaTypOpis
titleStringTytuł osi Y.

Powrót

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


setYAxisTitleTextStyle(textStyle)

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

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

Powrót

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