Class ScatterChartBuilder

ScatterChartBuilder

Builder für Streudiagramme. Weitere Informationen finden Sie in der Google Charts-Dokumentation.

Hier ist ein Beispiel für das Erstellen eines Streudiagramms. Die Daten werden aus einer Google-Tabelle importiert.

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

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

const chart = chartBuilder.build();

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
build()	Chart	Erstellt das Diagramm.
setBackgroundColor(cssValue)	ScatterChartBuilder	Legt die Hintergrundfarbe für das Diagramm fest.
setColors(cssValues)	ScatterChartBuilder	Legt die Farben für die Linien im Diagramm fest.
setDataSourceUrl(url)	ScatterChartBuilder	Legt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen.
setDataTable(tableBuilder)	ScatterChartBuilder	Legt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet.
setDataTable(table)	ScatterChartBuilder	Legt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält.
setDataViewDefinition(dataViewDefinition)	ScatterChartBuilder	Legt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.
setDimensions(width, height)	ScatterChartBuilder	Legt die Abmessungen für das Diagramm fest.
setLegendPosition(position)	ScatterChartBuilder	Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
setLegendTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil der Diagrammlegende fest.
setOption(option, value)	ScatterChartBuilder	Legt erweiterte Optionen für dieses Diagramm fest.
setPointStyle(style)	ScatterChartBuilder	Legt den Stil für Punkte in der Linie fest.
setTitle(chartTitle)	ScatterChartBuilder	Legt den Titel des Diagramms fest.
setTitleTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil des Diagrammtitels fest.
setXAxisLogScale()	ScatterChartBuilder	Legt fest, dass die horizontale Achse logarithmisch skaliert wird. Dazu müssen alle Werte positiv sein.
setXAxisRange(start, end)	ScatterChartBuilder	Legt den Bereich für die horizontale Achse des Diagramms fest.
setXAxisTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil der horizontalen Achse fest.
setXAxisTitle(title)	ScatterChartBuilder	Fügt der horizontalen Achse einen Titel hinzu.
setXAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil für den Titel der horizontalen Achse fest.
setYAxisLogScale()	ScatterChartBuilder	Die vertikale Achse wird logarithmisch skaliert. Dazu müssen alle Werte positiv sein.
setYAxisRange(start, end)	ScatterChartBuilder	Legt den Bereich für die vertikale Achse des Diagramms fest.
setYAxisTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil der vertikalen Achse fest.
setYAxisTitle(title)	ScatterChartBuilder	Fügt der vertikalen Achse einen Titel hinzu.
setYAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Legt den Textstil für den Titel der vertikalen Achse fest.

Detaillierte Dokumentation

build()

Erstellt das Diagramm.

Rückflug

Chart: Ein Diagrammobjekt, das in Dokumente oder UI-Elemente eingebettet oder als statisches Bild verwendet werden kann.

---

setBackgroundColor(cssValue)

Legt die Hintergrundfarbe für das Diagramm fest.

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

Parameter

Name	Typ	Beschreibung
cssValue	String	Der CSS-Wert für die Farbe, z. B. "blue" oder "#00f".

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setColors(cssValues)

Legt die Farben für die Linien im Diagramm fest.

// 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']);

Parameter

Name	Typ	Beschreibung
cssValues	String[]	Ein Array von CSS-Farbwerten, z. B. ["red", "#acf"]. Das n-te Element im Array stellt die Farbe der n-ten Linie im Diagramm dar.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setDataSourceUrl(url)

Legt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen. Wenn eine Datenquellen-URL und eine DataTable angegeben werden, wird die Datenquellen-URL ignoriert.

Weitere Informationen zum Abfragen von Datenquellen finden Sie in der Google Charts-Dokumentation.

Parameter

Name	Typ	Beschreibung
url	String	Die Datenquellen-URL, einschließlich aller Suchparameter.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setDataTable(tableBuilder)

Legt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet. Dies ist eine praktische Methode zum Festlegen der Datentabelle, ohne dass build() aufgerufen werden muss.

Parameter

Name	Typ	Beschreibung
tableBuilder	DataTableBuilder	Ein Tool zum Erstellen von Datentabellen. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt. Alle weiteren Aktualisierungen des Builders werden daher nicht im Diagramm berücksichtigt.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setDataTable(table)

Legt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält. Die erste Spalte muss ein String sein und die Labels für die horizontale Achse enthalten. Es können beliebig viele Spalten folgen, die alle numerisch sein müssen. Jede Spalte wird als separate Zeile dargestellt.

Parameter

Name	Typ	Beschreibung
table	DataTableSource	Die Datentabelle, die für das Diagramm verwendet werden soll.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setDataViewDefinition(dataViewDefinition)

Legt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.

Parameter

Name	Typ	Beschreibung
dataViewDefinition	DataViewDefinition	Ein Objekt zur Definition der Datenansicht, das die Ansicht definiert, die für das Zeichnen des Diagramms aus der angegebenen Datenquelle abgeleitet werden soll.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setDimensions(width, height)

Legt die Abmessungen für das Diagramm fest.

Parameter

Name	Typ	Beschreibung
width	Integer	Die Breite des Diagramms in Pixeln.
height	Integer	Die Höhe des Diagramms in Pixeln.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setLegendPosition(position)

Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt. Standardmäßig ist keine Legende vorhanden.

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

Parameter

Name	Typ	Beschreibung
position	Position	Die Position der Legende.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setLegendTextStyle(textStyle)

Legt den Textstil der Diagrammlegende fest.

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

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für die Diagrammlegende verwendet werden soll.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setOption(option, value)

Legt erweiterte Optionen für dieses Diagramm fest. Verfügbare Optionen für dieses Diagramm Diese Methode hat keine Auswirkungen, wenn die angegebene Option ungültig ist.

// Build a scatter chart with a 1-second animation duration.
const builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parameter

Name	Typ	Beschreibung
option	String	Die festzulegende Option.
value	Object	Der festzulegende Wert.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setPointStyle(style)

Legt den Stil für Punkte in der Linie fest. Standardmäßig haben Punkte keine besonderen Formatierungen und nur die Linie ist sichtbar.

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

Parameter

Name	Typ	Beschreibung
style	PointStyle	Der Stil, der für Punkte in der Linie verwendet werden soll.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

Weitere Informationen

• PointStyle

---

setTitle(chartTitle)

Legt den Titel des Diagramms fest. Der Titel wird zentriert über dem Diagramm angezeigt.

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

Parameter

Name	Typ	Beschreibung
chartTitle	String	den Diagrammtitel.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setTitleTextStyle(textStyle)

Legt den Textstil des Diagrammtitels fest.

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

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für den Diagrammtitel verwendet werden soll. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisLogScale()

Legt fest, dass die horizontale Achse logarithmisch skaliert wird. Dazu müssen alle Werte positiv sein.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisRange(start, end)

Legt den Bereich für die horizontale Achse des Diagramms fest.

Wenn Datenpunkte außerhalb des Bereichs liegen, wird der Bereich erweitert, um diese Datenpunkte einzuschließen.

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

Parameter

Name	Typ	Beschreibung
start	Number	Der Wert für die unterste Rasterlinie der horizontalen Achse.
end	Number	Der Wert für die oberste Rasterlinie der horizontalen Achse.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisTextStyle(textStyle)

Legt den Textstil der horizontalen Achse fest.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisTitle(title)

Fügt der horizontalen Achse einen Titel hinzu. Der Titel ist zentriert und wird unter den Achsenwertlabels angezeigt.

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

Parameter

Name	Typ	Beschreibung
title	String	Der Titel für die X-Achse.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der horizontalen Achse fest.

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisLogScale()

Die vertikale Achse wird logarithmisch skaliert. Dazu müssen alle Werte positiv sein.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisRange(start, end)

Legt den Bereich für die vertikale Achse des Diagramms fest. Wenn Datenpunkte außerhalb des Bereichs liegen, wird der Bereich erweitert, um diese Datenpunkte einzuschließen.

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

Parameter

Name	Typ	Beschreibung
start	Number	Der Wert für die unterste Rasterlinie der vertikalen Achse.
end	Number	Der Wert für die oberste Gitterlinie der vertikalen Achse.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTextStyle(textStyle)

Legt den Textstil der vertikalen Achse fest.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTitle(title)

Fügt der vertikalen Achse einen Titel hinzu. Der Titel ist zentriert und wird links neben den Wertlabels angezeigt.

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

Parameter

Name	Typ	Beschreibung
title	String	Der Titel für die Y-Achse.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der vertikalen Achse fest.

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

ScatterChartBuilder – Dieser Builder, nützlich für die Verkettung.